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Preface 


This manual is your primary source for information about upgrading and 
installing the OpenVMS VAX Version 7.1 operating system. Before you attempt 
to install or upgrade the operating system, be sure to read all the release notes 
and cover letters Gf any) included in your distribution kit. 


If you received factory-installed software with your computer, read that user 
documentation first for information about starting up your system. Otherwise, 
use this manual for step-by-step instructions for performing an installation or 
an upgrade. When the instructions in this manual direct you to do so, refer to 
the upgrade and installation supplement for information specific to your VAX 
computer. 


Intended Audience 


If you are responsible for installing or upgrading the OpenVMS operating system 
and for performing related backup, shutdown, and startup procedures, read 

this manual before you install or upgrade to Version 7.1 of the OpenVMS VAX 
operating system. 


Document Structure 


The information in this manual is organized as follows: 


e Chapter 1 provides an overview of the upgrade and installation procedures. 
It describes what happens during an installation or an upgrade, lists some 
changes and restrictions you should be aware of, and refers you to the 
appropriate documentation. 


e Chapter 2 describes the tasks you must perform before installing the 
OpenVMS VAX operating system. 


e Chapter 3 describes how to install Version 7.1 of the OpenVMS VAX operating 
system on a VAXcluster or a standalone VAX computer. 


e Chapter 4 lists the tasks you should perform after you install the OpenVMS 
VAX operating system. 


e Chapter 5 contains cautions, restrictions, and requirements for upgrading 
your VAX computer system and tells you how to prepare your system for an 
upgrade. 


e Chapter 6 contains additional information for upgrading a VAXcluster 
environment. 


e Chapter 7 describes the procedure for upgrading a standalone VAX computer. 
e Chapter 8 lists the tasks you should perform after the upgrade. 


e Chapter 9 describes how to customize DECwindows device support software. 


xili 


® 


Chapter 10 describes how to use VMSTAILOR and DECW$TAILOR to add or 
remove optional OpenVMS software. 


Appendix A provides a quick method of applying multiple upgrades to a VAX 
system. 


Appendix B provides notes and supplemental license management 
information to the upgrade and installation procedures. 


Appendix C describes how tc boot from the [SYSF] directory on the different 


types of VAX computers. 


Appendix D lists the subclasses in the OpenVMS VAX optional save sets C, D, 
E, and F. 


Appendix E lists DECwindows display server and font files. 


Appendix F lists files installed either over or under the version numbers of 
existing files during an upgrade. 


Appendix G describes how to prepare your OpenVMS system and your PC to 
run the OpenVMS Management Station server and client software. 


Appendix H describes methods for managing small capacity system disks, 
including some specific recommendations for installing or upgrading to the 
OpenVMS VAX Version 7.1 operating system and the DECwindows Motif for 
OpenVMS Version 1.2—3 layered product. : 


The Glossary defines commonly used terms. 


The Index provides a quick way to find information. 


Related Documents 


The following documents contain information associated with performing an 
upgrade or installation: 


XIV 


The upgrade and installation supplement for your VAX computer—Provides 
supplemental information necessary during an installation or upgrade, such 
as booting the system and determining device names. 


OpenVMS Version 7.1 Release Notes —Describes changed and enhanced 
software features, software problems and restrictions, and changes to the 
documentation for Version 7.1 of the OpenVMS VAX operating system. 


OpenVMS Version 7.1 New Features Manual—Describes new software © 
features for the OpenVMS Version 7.1 operating system. 


OpenVMS Cluster Systems—Describes the procedures for establishing and 
managing VAXcluster configurations. 


OpenVMS License Management Utility Manual—Provides information about 
registering and managing licenses on an OpenVMS VAX system. 


OpenVMS Guide to System Security—Describes security features provided by 
the OpenVMS VAX operating system, including criteria for C2 systems. 


OpenVMS System Manager’s Manual—Provides task-oriented information | 
about managing an OpenVMS system, including how to use the VMSINSTAL 
command procedure. 


OpenVMS DCL Dictionary—Provides detailed reference information and 
examples for all OpenVMS DCL commands. 


e OpenVMS System Management Utilities Reference Manual: M—Z—Provides 
complete information about using the POLYCENTER Software Installation 
utility PRODUCT command. 


e The hardware manuals supplied with your VAX computer provide detailed 
information about system hardware. 


For additional information about the Open Systems Software Group (OSSG). 
products and services, access the Digital OpenVMS World Wide Web site. Use the 
following URL: 


http: //www.openvms.digital.com 


Reader’s Comments 
Digital welcomes your comments on this manual. | 


Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and 
send us your comments by: 


Internet openvmsdoc@zko.mts.dec.com 


Fax 603 881-0120, Attention: OSSG Documentation, ZKO3-4/U08 
Mail OSSG Documentation Group, ZKO3-4/U08 


110 Spit Brook Rd. 
Nashua, NH 03062-2698 


How To Order Additional Documentation 


Use the following table to order additional documentation or information. 
If you need help deciding which documentation best meets your needs, call 
800-DIGITAL (800-344-4825). | 
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Telephone and Direct Mail Orders 


Location Call Fax Write 
U.S.A. DECdirect Fax: 800—234—2298 Digital Equipment Corporation 
| 800—DIGITAL P.O. Box CS2008 : 
800-344-4825 | Nashua, NH 03061 
Puerto Rico 809-781-0505 Fax: 809-749-8300 Digital Equipment Caribbean, inc. 


3 Digital Plaza, Ist Street, Suite 200 
P.O. Box 11038 

Metro Office Park 

San Juan, Puerto Rico 00910-2138 


Canada , 800-267-6215 Fax: 613-592-1946 Digital Equipment of Canada, Ltd. 
~ Box 13000 
100 Herzberg Road 
Kanata, Ontario, Canada K2K 2A6 
Attn: DECdirect Sales 


International a "= = Local Digital subsidiary or 
: approved distributor 
Internal Orders DTN: 264-4446 _. Fax: 603-884-3960 U.S. Software Supply Business 
603-884-4446 Digital Equipment Corporation 
| 8 Cotton Road 
Nashua, NH 03063-1260 
ZK-7654A-GE 
Conventions 
In this manual, every use of OpenVMS VAX means the OpenVMS VAX operating 
system. 


Every use of DECwindows and DECwindows Motif refers to DECwindows Motif 
for OpenVMS software. 


The following conventions are also used in this manual: 


Ctrl/x | A sequence such as Ctrl/x indicates that you must hold down 
the key labeled Ctrl while you press another key or a pointing 
device button. | 


PF1 x A sequence such as PF 1 x indicates that you must first press 
and release the key labeled PF 1, then press and release 
another key or a pointing device button. 


In examples, a key name enclosed in a box indicates that 
you press a key on the keyboard. (In text, a key name is not 
enclosed in a box.) 
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() 


{} 


text style 


ttalic text 


UPPERCASE TEXT 


numbers 


A horizontal ellipsis in examples indicates one of the following 
possibilities: 


e Additional optional arguments in a statement have been 
omitted. 3 


e The preceding item or items can be repeated one or more 
times. 


e Additional parameters, values, or other information can be 
entered. 


Vertical ellipsis points indicate the omission of items from 
a code example or command format; the items are omitted 
because they are not important to the topic being discussed. 


In format descriptions, parentheses indicate that, if you 
choose more than one option, you must enclose the choices 
in parentheses. 


In format descriptions, brackets indicate optional elements. 
You can choose one, none, or all of the options. (Brackets are 
not optional, however, in the syntax of a directory name in 
an OpenVMS file specification, or in the syntax of a substring 
specification in an assignment statement.) 


In format descriptions, braces surround a required choice of 
options; you must choose one of the options listed. 


This text style represents the introduction of a new term or the 
name of an argument, an attribute, or a reason. 


This style is also used to show user input in Bookreader 
versions of the manual. 


Italic text emphasizes important information, indicates 
variables, and indicates complete titles of manuals. Italic 
text also represents information that can vary in system 
messages (for example, Internal error number), command lines 
(for example, /PRODUCER=name), and command parameters 
in text. 


Uppercase text indicates a command, the name of a routine, 
the name of a file, or the abbreviation for a system privilege. 


A hyphen in code examples indicates that additional 
arguments to the request are provided on the line that follows. © 


All numbers in text are assumed to be decimal, unless 
otherwise noted. Nondecimal radixes—binary, octal, or 
hexadecimal—are explicitly indicated. 


This manual often refers to products by their abbreviated names. For example, 

the VAX 8200, VAX 8250, VAX 8300, and VAX 8350 computers are referred to as 
the VAX 8200, 8250, 8300, 8350. The MicroVAX 2000 computer is referred to as 
the MicroVAX 2000, and so on. 
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Overview of Installation and Upgrade 
Procedures 


1.1 Introduction 


This chapter provides a general description of what happens during the 
installation and upgrade procedures, including information you should be aware 
of before you upgrade to or install the OpenVMS VAX Version 7.1 operating 
system. 


This chapter also describes the contents of the distribution kit, tells you whether 
you should do an installation or an upgrade, and refers you to the appropriate 
documentation. 


1.2 Important Information 


Before you install or upgrade to OpenVMS VAX Version 7.1, you should review 
the information in this section. 


1.2.1 DECnet—Plus 


The OpenVMS VAX Version 7.1 kit includes the DECnet—Plus software. The 
DECnet Phase IV product is no longer part of the operating system installation 
and upgrade menus. During the OpenVMS VAX installation or upgrade 
procedure, you are given the option to install the DECnet—Plus product. Whether 
or not you chose to install DECnet—Plus, DECnet Phase IV will not be present on 
your system after you install or upgrade to OpenVMS VAX Version 7.1. 


A kit containing the DECnet—Plus software is provided with the OpenVMS VAX 
Version 7.1 kit. In future releases, customers who do not receive the operating 
system installation kit on CD-ROM will need to purchase the DECnet—Plus 
media and documentation separately. 


If you want to use the DECnet Phase IV product, a DECnet Phase IV kit is 
provided, which you can install after you have installed OpenVMS VAX Version 
7.1. However, be aware that, if you install or reinstall DECnet Phase IV, you 
must purchase a separate support contract. 


Note 


If DECnet—Plus is installed on your system, you must remove that 
product before you install the DECnet Phase IV product. Both DECnet 
products cannot run at the same time. 
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To install DECnet Phase IV, do the following after the OpenVMS VAX installation 
or upgrade is complete: 


If DECnet—Plus is installed on your system, use the PRODUCT REMOVE 
command to remove that product. (See OpenVMS System Management 
Utilities Reference Manual: M~Z for complete information about using the 


‘PRODUCT command.) 


Mount the distribution media that contains the DECnet Phase IV kit. 


For example, if your OpenVMS VAX distribution media is on CD-ROM and 
you want to mount it on a local drive, DKA400, you would enter a command 
similar to the following: 


$ MOUNT/OVER=ID DKA400 


If you are using an InfoServer device, enter the following command to see if 
the device DADO is present on your system: 


$ SHOW DEVICE DADO 
If DADO is not present, enter the following: 
S$ @SYSSSTARTUP: ESSSSTARTUP CLIENT 


Once DADO is present, bind to the service and mount the CD. For example, if 
the service name is VAXVMS071, you would enter a command similar to the 
following: 


$ MCR ESSSLADCP BIND VAXVMS071 
$ MOUNT/OVER=ID DADSVAXVMS071 


Now, invoke the POLYCENTER Software Installation utility and install 


DECnet Phase IV by entering a command similar to the following: 


$ PRODUCT INSTALL DECNET PHASE IV /SOURCE=DKA400:[KITS.DECNET PHASE IV KIT] 


For DKA400, substitute the correct name for your source drive. 


If your distribution media is on TK50 tapes, mount the TK50 volume that 
contains the DECnet Phase IV kit. 


For example, if the device name of your TK50 drive is MKA500, you would 
enter a command similar to the following: 


§ MOUNT/OVER=ID MKA500: 


Now, install the DECnet Phase IV product by entering a command similar to 
the following: 


$ PRODUCT INSTALL DECNET PHASE IV /SOURCE=MKA500: 


For MKA500:, substitute the correct name for your source drive. 


For more information about the DECnet—Plus product, see the OpenVMS Version 
7.1 New Features Manual and the DECnet/OSI for OpenVMS Installation and 
Configuration. 


1.2.2 DECwindows Motif for OpenVMS—Minimum Version 


For OpenVMS VAX Version 7.1, the minimum supported version of DECwindows 
Motif for OpenVMS is 1.2-3. 
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1.2.3 MACRO32.EXE and Standalone Backup 
To build standalone backup onto tape, you must have the image MACRO32.EXE 
on your system disk. Do not tailor off the Macro libraries before building 
standalone backup onto tape. 


1.2.4 Layered Product Availability 


The most current information about layered product support is available in the 
Software Public Rollout Reports for OpenVMS. These reports are available from 
the OpenVMS World Wide Web site in the “literature” section. Use the following 
URL: 


http://www.openvms.digital.com 


If you do not have access to the Internet, you can find the operating system 
support information on any of the quarterly Software Products Libraries, in the 
following directory: : 


[README ]SW_COMPAT MATRIX.PS (.TXT) 


1.2.5 Restrictions 
Restrictions for OpenVMS VAX Version 7.1 include: 


e The minimum memory requirement is 4 megabytes. 
¢ The MA780 shared memory is not supported. 


e You cannot install or upgrade to Version 7.1 of the OpenVMS VAX operating 
system on the following VAX computers and system disks: 


Computers MicroVAX I, VAXstation I, VAXstation 8000, VAX—11/725, and 
VAX—11/782 

System disks RKO7, RLO2, RC25, RD32, RD51, RD52, RD53, RZ22, and 
RZ23L. 


e If your system uses a small-capacity system disk (less than 210 megabytes), 
the entire OpenVMS VAX Version 7.1 operating system and the complete 
DECwindows Motif for OpenVMS VAX layered product will not fit on your 
disk. Appendix H describes some methods that will enable you to install or 
upgrade to OpenVMS VAX Version 7.1 and DECwindows Motif for OpenVMS 
VAX on a small-capacity system disk. 


Note that you can use the methods described in Appendix H to free up disk 
space on any system. 


For more information about these restrictions, see the OpenVMS Operating 
System for VAX and Alpha, Version 7.1 Software Product Description (SPD). 
1.3 Definitions: A Few Key Terms 


You should be familiar with the following key terms before performing an 
installation or upgrade: | 


Term Definition 
Distribution Media The media containing the OpenVMS VAX operating 


system software. This software is supplied in a format 
that the computer cannot use until you perform an 
installation or upgrade. 
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Term 


System Disk 


InfoServer 


Source Drive 


Target Drive 


HSC Drive 


Definition 


The disk that contains (or will contain) the OpenVMS 
VAX operating system in a usable format. The | 
installation or upgrade procedure converts the | 
OpenVMS VAX operating system software to this 
usable format when transferring the software from the 
distribution media to the system disk. 


A drive that is connected directly to a VAX computer. 
For example, a eee tape drive connected directly 
to a VAX computer is referred to as a local tape drive. 
If you have a standalone VAX computer, it is likely all 
the drives connected to your system are local drives. 


A general-purpose disk storage server that allows 
you to use the distribution compact disc to install the 
operating system on remote client systems connected 
to the same LAN (local area network). 


The drive that holds the distribution media during the 
upgrade or installation. 


The drive that holds the system disk—or, for some 
files, the alternate disk—during the upgrade or 
installation. 


A drive connected to a hierarchical storage controller 
(HSC) device. For example, a magnetic tape drive 
connected to an HSC device is referred to as an HSC 
tape drive. 


The HSC is a self-contained, intelligent, mass storage 
subsystem that enables VAXcluster nodes to share 
Digital Storage Architecture ee disks. 


For definitions of other specialized terms used in this manual, see the Glossary at 


the end of this book. 


1.4 Locating Files on the Distribution Media 
The OpenVMS VAX files are stored on the distribution media as the following 


save sets: 

Save Set Name Description 

-VMS071.A | Required 

VMS071.B Required 

VMS071.C Library (optional) 

VMS071.D Optional (optional) 

VMS071.E Help Message (optional) 

VMS071.F OpenVMS Management Station software PC files (optional) 


See Appendix D for descriptions of the file subclasses contained in the optional 


save sets. 


The optional DECwindows support files are stored on the distribution media as 


the following save sets: 
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Save Set Name Description 

DECW071.C Base support files 
DECW071.D Workstation support files 
DECW071.E _ 75 dots-per-inch (dpi) font files 


DECW071.F 100 dpi font files 


1.4.1 On Magnetic Tape 


The OpenVMS VAX Version 7.1 magnetic tape kit contains OpenVMS VAX 
software on four tapes. The first tape contains the required save sets VMS071.A 
and VMS071.B. The second tape contains the save set VMS071.C. The third 
tape contains save sets VMS071.D, VMS071.E, and VMS0701F. The fourth tape 
contains the DECwindows base support and workstation support files, and DEC 
AMDS files. 


1.4.2 On Tape Cartridges 


The OpenVMS VAX Version 7.1 TK50 tape kit contains OpenVMS VAX software 
on two tape cartridges. The first cartridge contains VMS071.A, VMS071.B, 

and VMS071.C save sets. The second cartridge contains standalone BACKUP, 
VMS071.D, VMS071.E, and VMS071.F save sets, DECwindows base support and 
workstation support files, and DEC AMDS files. 


1.4.3 On Compact Disc 


The OpenVMS VAX Version 7.1 compact disc kit contains all the save sets and 
DECwindows base and workstation support files on one compact disc. (For more 
information, see the Guide to OpenVMS Version 7.1 CD-ROMs.) 


Note that you can install or upgrade the operating system from a local compact 
disc drive as well as from an InfoServer device. 


1.4.4 DECamds and Monitoring Performance History (MPH) Files 


The DECamds software is included as save sets AMDS071.A and AMDS071.B 
on the OpenVMS VAX distribution media. The save sets are located on the third 


magnetic tape volume, on the second tape cartridge, and on the compact disc in 
the [AMDS071] directory. 


The Monitoring Performance History (MPH) kit is also included on the OpenVMS 
VAX distribution media. The MPH kit is located on the third magnetic tape, on 
the second tape cartridge, and on the compact disc in the [MPH] directory. 


1.4.5 Software Product Descriptions (SPDs) 


The following SPD files are located on the second tape cartridge of the TK50 
distribution kit and the third tape of the magnetic tape distribution kit. These 
SPD files have been grouped into an OpenVMS BACKUP save set named 
VMS071_SPD.BCK. File names with the .PS extension are in PostScript format. 
File names with the .TXT extension are in plain ASCII text format. 


DECNET_SPD.PS DECnet—Plus for OpenVMS VAX and Alpha, Version 
DECNET_SPD.TXT 7.1 

OVMS_71_SPD.PS OpenVMS Operating System for VAX and Alpha, 
OVMS_71_SPD.TXT Version 7.1 | 
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RMS_SPD.PS RMS Journaling for OpenVMS, Version 7.1 
RMS_SPD.TXT 

CLUSTER _SPD.PS OpenVMS Cluster Software 
CLUSTER_SPD.TXT 

VOL_SHAD _SPD.PS Volume Shadowing for OpenVMS, Version 7.1 


VOL_SHAD_SPD.TXT 


To obtain all the SPD files and restore them to your current default directory, 
enter a BACKUP command using the following format: 


BACKUP source-drive:VMS071 SPD.BCK /SAVE SET *.*;+* 


For source-drive, substitute the name of the device that holds your iuedbatien 
kit. For ample: if your source-drive is a local magnetic tape drive with the 
device name MUAO, you would enter the following command: 


$ BACKUP MUAO:VMS071 SPD.BCK/SAVE SET *.*;* 


To restore all the SPD files in PostScript format to your default directory, enter 
the following: 


$ BACKUP MUAO: vMSO71. _SPD.BCK/SAVE SET/SELECT=*.PS *.¥*;* 


The following command restores the PostScript SPD file for the OpenVMS VAX 
and OpenVMS Alpha operating systems to your current default directory: 


$ BACKUP MUAO:VMS071_SPD.BCK/SAVE SET/SELECT=OVMS 71 SPD.PS *.*;* 


If your distribution kit is on compact disk, the SPD files are located in the 
[DOCUMENTATION.V071] directory. For information about locating and printing 
these SPD files, see the Guide to OpenVMS Version 7.1 CD-ROMs. 


1.5 What Happens During an Installation 


When you install the OpenVMS VAX operating system, the installation procedure 
does the following: 


e Initializes the system disk, overwriting its contents. 
e Creates a system directory structure. 
e Transfers the OpenVMS VAX files from the distribution media to the system 
disk. Some files can be transferred to an alternate disk. 
1.5.1 When to Perform an Installation 


Use the installation procedure under the following conditions: 


e If your VAX computer is new (it has never had any version of the operating 
system running on it, including factory-installed software). 


e If your VAX computer is running a previous version of the operating system 
and you. want to overwrite the entire contents of the system disk (the 
OpenVMS VAX operating system, application software, and user files). 


e Ifyou are running a previous version of the operating system, but you cannot 
upgrade. For example, if you changed the names of system directories on the 
system disk, the upgrade procedure will not work correctly. You can either 
restore the system disk to its original directory structure, or you can reinstall 
the OpenVMS VAX operating system. 
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Caution: The installation procedure initializes the system disk, overwriting 
its contents. For this reason, use the installation procedure only on new VAX 
computers or if you want to destroy the contents of the system disk. 


1.5.2 How to Use the Installation Documentation 


This manual contains step-by-step instructions for performing an OpenVMS 
VAX installation. However, you will need to refer to several different documents 
before and during the installation. Figure 1—1 illustrates the major steps in an 
installation and the documents you will use to perform each step. 
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Figure 1-1 Documentation Used to Perform an Installation 


Hardware manuals 


Install and 
test hardware 


OpenVMS VAX Upgrade and Installation Manual 


\ OpenVMS Release Notes 


—_ \\, OpenVMS New Features 


Read 
release—specific 
documents 


=" Upgrade and Installation Supplement 


\ for your VAX computer 


Perform 
preinstallation 
tasks 


Boot standalone 
BACKUP to 
begin installation 


Continue 
installation 


: = Upgrade and Installation Supplement 


_ Boot new ‘ for your VAX computer 


system disk 


Complete installation 


Perform 
postinstallation 
tasks 


: -s Upgrade and Installation Supplement 


\\ for your VAX computer 


Build standalone 
_ BACKUP and 
backup system disk 
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1.6 What Happens During an Upgrade 


1.6.1 When 


When you upgrade the OpenVMS VAX operating system, the upgrade procedure 
does the following: 


e Deletes and purges some OpenVMS VAX files on the system disk but leaves 
all the user files intact. 


e Transfers the new OpenVMS VAX files from the distribution media to the 
system disk. | 
Note: The upgrade procedure puts the most recent versions of the OpenVMS 
VAX files in SYS$COMMON. 


e Merges some of the old OpenVMS files and the new OpenVMS VAX files and 
replaces others. 


Certain OpenVMS VAX files are placed either over or under existing files 
(that is, they are given a version number above or below the version number 
of the existing file). This is done to protect any customizations to the files and 
results in having two versions of the file when the upgrade is completed. For 
more information, see Appendix F. 


e Cleans up files and structures used only during the upgrade. 


e Leaves your OpenVMS license and System Integrated Product (SIP) licenses 
intact. 


You do not need to reinstall these licenses after you upgrade. (See Appendix B 
for detailed information about license management for OpenVMS VAX Version 
7.1.) 


to Perform an Upgrade 


In most cases, you can use the upgrade procedure to obtain a higher version 

of the OpenVMS VAX operating system. Unlike the installation procedure, the 
upgrade procedure does not initialize your system disk. This means you can get 
the latest version of the operating system and keep your user files and optional 
software files intact. | 


1.6.2 How to Use the Upgrade Documentation 


This manual contains step-by-step instructions for performing an OpenVMS VAX 
upgrade. However, you will need to refer to several different documents before 
and during an upgrade. Figure 1—2 illustrates the major steps in an upgrade and 
the documents you will use to perform each step. 
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_ Figure 1-2 Documentation Used to Perform an Upgrade 


=== OpenVMS VAX Upgrade and Installation Manual 
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release—specific 
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Backup \\ for your VAX computer 
system disk \" 


BEGIN 
Perform | 
preupgrade 
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Perform upgrade oe and Installation Supplement 


\ for your VAX computer 


Perform 
postupgrade 
task 


=> | Upgrade and Installation Supplement 


Build standalone. 
\ for your VAX computer 


BACKUP and 
backup system disk 
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1.7 Where to Go Next 
' If you are installing the OpenVMS VAX operating system, go to Chapter 2. 


If you are upgrading the OpenVMS VAX operating system, go to Chapter 5. 
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Before Installing OpenVMS VAX Software 


2.1 Overview 


This chapter describes how to prepare for installing the OpenVMS VAX operating 
system, including: 


Being aware of the cautions and restrictions 
Ensuring your hardware is ready 

Ensuring your software distribution kit is complete 
Preparing for a C2 system 

Preparing for a VAXcluster environment 

Preparing your tape and disk drives 


Gathering the information you need to supply during the installation 
procedure 


Completing the preinstallation checklist 


If you are an experienced system manager, you can use the checklist at the end of 
the chapter to complete all the necessary preinstallation tasks. 


If you are a less-experienced system manager, you should read the entire chapter 
and then use the checklist to make sure you completed all the preinstallation 
tasks. 


2.2 Cautions and Restrictions 


Before you begin the installation procedure, note the following cautions and 
restrictions. 


2.2.1 Cautions 


The following cautions apply for Version 7.1 of the OpenVMS VAX operating 
system: 


e The software installation procedure overwrites the contents of the system 


disk. Use the installation procedure only if your VAX computer is new or 
if you want to destroy the contents of the system disk. If your system disk 
contains files you want to save, you should upgrade to the new version of 
OpenVMS VAX. For an overview of the upgrade procedure, see Chapter 5. 


Do not attempt to use VMSINSTAL with OPTION G to transfer OpenVMS 
VAX save sets to another media type; doing so will produce an unusable 
system. Instead, you can use the DCL command COPY to transfer save sets 
to another media type. 
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If you move the save sets from the distribution media before beginning the 
installation, you must move them to the [000000] directory on a disk that is 
not the system disk; otherwise, the installation will fail. 


2.2.2 Restrictions 


The following restrictions apply for Version 7.1 of the OpenVMS VAX operating 
system: 


e If your system contains DIGITAL Storage Systems Interconnect (DSSI) disks 
attached to a KFQSA controller, you will notice a change in the device names 
for DSSI disks attached to KFQSA controllers. 


When you boot standalone BACKUP, it will display the devices on your 
system using the new device naming scheme. Use the new device names 
throughout the installation and after you complete the installation. 


e Ifyou want to use DECwindows software with OpenVMS VAX Version 7.1, 
you must purchase and install the DECwindows Motif for OpenVMS Version 
1.2—8, or higher, layered product. For more information, see Section 1.2.1. 


2.3 Are You Ready to Install? 


Before you begin to install the OpenVMS VAX operating system, make sure you 
have all the required hardware and software components. 


2.3.1 Hardware Components 


Examine your hardware for the following: 


e Make sure the hardware has been installed and checked for proper operation. 
For detailed information about the hardware, see the hardware manual for 
your VAX computer. 


¢ Make sure you know how to turn on and operate your system components, | 
including the system unit, console, monitor, drives, terminals, and printers. If 
necessary, read the manuals that came with these components. 


e Set up your system to record the installation procedure on either a hardcopy 
terminal or a printer attached to the console terminal. If you do not do this, 
the screen messages will be lost. You will need a transcript in case there is a 
problem during the installation. For more information, see the upgrade and 
installation supplement for your computer. 


2.3.2 Software Components 


Examine your software for the following: 


e Make sure you have all the items listed on the bill of materials (BOM) in 
the OpenVMS VAX distribution kit. If your kit is incomplete, notify Digital 
Software Supply, and request priority shipment of any missing items. 


e Before installing the OpenVMS VAX operating system, review Appendix B of 
this manual for license management information, the OpenVMS Version 7.1 
New Features Manual, the OpenVMS Version 7.1 Release Notes, and any cover 
letters included with your kit. 


e Read the Before Installing OpenVMS section in the upgrade and installation 
_ supplement for your VAX computer, which describes tasks specific to your 
VAX computer that you must complete before beginning the installation. 
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2.4 Preparing for an Installation 


Now that you have determined that your hardware and software components are 
ready, you can make the necessary preparations for installing the OpenVMS VAX 
operating system. 


2.4.1 Preparing for a C2 System 


Many of the security features provided by the OpenVMS VAX operating system 
are directed toward the criteria for a C2 system, as defined in the Department 
of Defense Trusted Computer System Evaluation Criteria, published by the U.S. 
Department of Defense Computer Security Center (DOD 5200.28-STD). 


A C2 system is the shipped system that has been configured according to the 
guidelines in Appendix C of the OpenVMS Guide to System Security. Before 
installing OpenVMS VAX, become familiar with the requirements for operating 
an OpenVMS VAX system within the C2 framework. 


2.4.2 Preparing for a VAXcluster Environment 


If you are installing the OpenVMS VAX operating system in a VAXcluster 
environment, the installation procedure will ask you for information about your 
VAXcluster environment. Before proceeding, review OpenVMS Cluster Systems, 
which provides the information you will need to answer questions during the 
installation. 


Note: Entering incorrect information during the installation can force you to 
repeat the entire installation procedure. 


Table 2-1 lists the VAXcluster information you need and explains how to obtain 
that information. For a complete explanation, see OpenVMS Cluster Systems. 


Table 2—1 VAXcluster Information for Installations 


information You Need 


Type of configuration 


DECnet node name and 
node address 


Allocation class value 


How to Get It 


Configuration types are distinguished by the interconnect device that the VAX 
computers in the cluster use to communicate with one another: Computer 
Interconnect (CI), Ethernet, DIGITAL Storage Systems Interconnect (DSSIJ), 
or FDDI (Fiber Distributed Data Interface). 


Determined by the network or system manager for each VAX computer on the 
network. See your system or network manager for the DECnet node name and 
node address for the VAX computer on which you are installing the OpenVMS 
VAX operating system. See the DECnet/OSI for OpenVMS Installation and 
Configuration for more information. | 


During the installation procedure you will be asked for the ALLOCLASS value 
of the VAX computer on which you are installing the OpenVMS VAX operating 
system. For example: 


Enter a value for MYNODE’s ALLOCLASS parameter: 


Refer to OpenVMS Cluster Systems for the rules on aecenane sinoeatien 
class values. Note that, in a mixed-interconnect VAXcluster environment, the 
allocation class value cannot be zero. It has to be a value between 1 and 255. 
This is also true for any VAX computer that is connected to a dual-pathed 
disk. 


When you enter the allocation class value, the installation procedure uses it to 
automatically set the value of the system parameter ALLOCLASS. 


(continued on next page) 
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Table 2—1 (Cont.) VAXcluster Information for Installations 


Information You Need How to Get It 


Quorum disk 


See OpenVMS Cluster Systems to determine whether you want a quorum disk 
in the cluster. 


Location for page and See OpenVMS Cluster Systems to determine where the page and swap files 


swap files 


MOP servers, disk 
servers, tape servers 


will be located for the system from which you are installing the OpenVMS 
VAX operating system software. — 


To establish either a local area or a mixed-interconnect cluster, seats 
which systems will be Maintenance Operations Protocol (MOP) servers, disk 
servers, and tape servers. Refer to OpenVMS Cluster Systems. 


Cluster group number and_ To establish either a local area or a mixed-interconnect cluster. 


cluster password 


Cluster group number: A number in the range from 1 to 4095 or from 61440 
to 65535. 


Cluster password: Can range from 1 to 31 alphanumeric characters, including 
dollar signs ($) and underscores (_). 


2.4.3 Preparing Tape and Disk Drives 


_ Prepare your tape and disk drives using the following steps: 


1. 


3. 


A. 


Decide which drive will hold the distribution tape and which drive will hold 
the system disk. Determine the device names for each drive, and write these 


names on a piece of paper. You will need this information throughout the 


installation. If you need information about devices and device names, refer to 
the Before Installing the OpenVMS Operating System section in the upgrade 
and installation supplement for your VAX computer. 


Note: Do not place the distribution media in the drive at this point. 


Follow this step only if the source drive or target drive is attached to a 
hierarchical storage controller (HSC). Otherwise, go to step 3. 


Make sure that both the CI and HSC devices are turned on and on line. 
Obtain the HSC name from the system manager, or use the following 
procedure: 


a. Press Ctrl/C at the HSC console terminal. | 
b. Enter the following command at the HSC> prompt and press Return: 
HSC> SHOW SYSTEM 
The information displayed includes the name of the HSC. For example: 


22-NOV-1996 15:00:00.00 Boot:12-NOV-1996 11:31:11.41 Up: 51:00 
Version V350 System ID: %X000000011 Name: MUTT 


DISK allocation class = 1 TAPE allocation class = 0 
Start command file Disabled 


SETSHO - Program Exit 
For more information, see the HSC User’s Guide. 


Place a scratch disk in the drive for the system disk (unless the system disk 
is fixed). 


Spin up the disk that will be the system disk but do not write protect it. 
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2.4.4 Information You Need During the Installation 


During the installation, the procedure prompts you to supply certain information. 
To save time once the procedure begins, be sure you have the following 
information available. Remember, entering incorrect information during the 
installation could force you to repeat the entire installation procedure. 


Required Information 


Passwords 


SCSNODE and 
SCSSYSTEMID parameters 


Optional components and 
OpenVMS Management 
Station files 


Location for Help Message 
utility 


Explanation 


You will be prompted to type passwords of at least 8 characters for the 
SYSTEM, SYSTEST, and FIELD accounts. 


If you are installing a standalone system, you will be prompted to supply an 
SCSNODE name and an SCSSYSTEMID. The SCSNODE name must be'a 
1- to 6-character unique DECnet node name. The SCSSYSTEMID system 
parameter is calculated as follows: 


(DECnet area * 1024) + node number 


Note that, if you are installing the operating system in a VAXcluster 
environment, the installation procedure does not prompt you to supply 
these parameters. It calculates the SCSNODE and SCSSYSTEMID based 
on the DECnet node name and node address that you supply earlier in the 
procedure. 


The installation procedure prompts you to specify whether you want to 
install the library (VMS071.C), optional (VMS071.D) OpenVMS components, 
and OpenVMS Management Station software PC files (VMS071. a 
Appendix D lists the files included in these save sets. 


You can save some space on your system disk if you choose not to install 
these components, but be sure to review Appendix D before deciding. 


Save set VMS071.E contains the online Help Message utility, which you can 
install on your system disk or on an alternate disk. (However, if you copied 
the distribution kit to some other media from which you will be performing 
the installation, you cannot install this save set on that media.) 
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Required Information 


DECwindows components 


PAK information 


Explanation 


The installation procedure prompts you to specify which of the following 
DECwindows components you want to install: 


e DECwindows base Bupport (required for running DECwindows software), 
which includes: 


—~ DECwindows transport 
— DECwindows keymaps 


e DECwindows workstation support (required for VAX workstations), 
which includes: 


— DECwindows X11 display server 
— Graphics drivers 
— 75 dots/inch video fonts 


— 100 dots/inch video fonts (option available only if you select 
DECwindows workstation support) 


You must install the DECwindows Motif for OpenVMS (previously 

called VMS DECwindows Motif) layered product if you want to run the 
DECwindows software. DECwindows Motif for OpenVMS Version 1.2—3 

(or 1.2 if the VAXMOTF05_012 remedial kit is installed) is the minimum 
supported version for systems running OpenVMS VAX Version 7.1. If you do 
not know which version of DECwindows Motif you are currently running on 
your system, you can check by entering the following command: 


$ ANALYZE/IMAGE SYSSLIBRARY : DECWSXLIBSHR. EXE 


Note: The DECwindows Motif for OpenVMS layered product does not 
have the DECwindows base and workstation support components. To get 
full DECwindows support, you must select the DECwindows components 
provided with the OpenVMS VAX kit and install the separate DECwindows 
Motif for OpenVMS layered product, which supports both Motif and XUI 
environments. 


The information listed on Product Authorization Keys (PAKs) for your 
OpenVMS VAX license and any system-integrated products you will run. 
The installation procedure gives you the opportunity to register any licenses 
you have. To register your licenses, you will need to enter the information 
listed on the PAK for each license. 


2.5 Preinstallation Checklist 


Before you begin the installation, use the following checklist to make sure you 
have completed all of the tasks described in this chapter: 


at ee ee 


Read the cautions and restrictions described at the beginning of this chapter. 


Make sure the hardware is installed and tested. (Described in the hardware 
manuals for your VAX computer.) 


Check the contents of your kit against the bill of materials (BOM). 
Read Appendix B of this manual, the OpenVMS Version 7.1 New Features 


Manual, the OpenVMS Version 7.1 Release Notes, and any cover letters 
included with your kit. 


a 


Read Section 2.4.1 for special considerations about running the OpenVMS 


VAX operating system in a C2 environment if you intend to create a C2 
compliant environment. 
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[ | Turn on the system. (Described in the upgrade and installation supplement 
for your VAX computer.) 


[ |] Set up your system to record the installation procedure. (Described in the 
upgrade and installation supplement for your VAX computer.) 


[| _] Read the Before Installing OpenVMS section in the upgrade and installation 
supplement for your VAX computer and perform the tasks described there. 


| _] Make sure you have the most recent version of the console media if you have 
a VAX computer that uses console media. (Described in the upgrade and 
installation supplement for your VAX computer.) 


[_] Determine whether you want a CI only, local area, or mixed-interconnect 
cluster if you are installing the OpenVMS VAX operating system on a VAX 
computer in a VAXcluster environment. (Described in OpenVMS Cluster 
Systems.) 


You should have the following information, depending on the type of 
VAXcluster: 


e CI Only VAXcluster: Get the allocation class value, DECnet node name, 
and DECnet node address for the computer. You also need to decide if you 
want a quorum disk and where the page and swap files for the system 
from which you are installing will be located. 


e Local Area and Mixed-Interconnect VAXclusters: Get the allocation class 
value, the DECnet node name, the DECnet node address, the cluster 
group number, and the cluster password. You also need to decide if you 
want a quorum disk and where the page and swap files for the system 
from which you are installing will be located. 


Prepare the disk and tape drives. (Described in Section 2.4.3.) 


LI] 
[ | Make sure you have the following information (described in Section 2.4.4) 
available: 


e Passwords containing at least 8 characters for the SYSTEM, SYSTEST, 
~ and FIELD accounts. 


e SCSNODE and SCSSYSTEMID if you are installing a standalone system. 
e A list of optional OpenVMS VAX components you want to install. 
e A list of optional DECwindows support components you want to install. 


e Information listed on Product Authorization Keys (PAKs) for your 
OpenVMS VAX license and any system-integrated products you will run. 


After you have performed all the tasks in the checklist, go to Chapter 3 to begin 
the installation. 
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Installing the OpenVMS VAX Operating System 


3.1 Overview 


During the installation procedure, OpenVMS VAX files are transferred from 

the distribution media to the system disk or, for certain files, to an alternate 
disk. The time required to complete an installation varies depending on your 
hardware configuration and on the distribution media you are using. In most 
cases, magnetic tapes and tape cartridges require more time than compact discs. 


The following installation tasks are described in this chapter: 
e Booting standalone BACKUP 

e Creating the system disk 

e Configuring a cluster 

e Setting passwords 
-e Creating the rights database 

e Registering licenses 

e Running AUTOGEN 


At certain points in the procedure you will need to refer to the upgrade and 
installation supplement for installation instructions that are specific to your VAX 
computer. , 


3.2 Booting Standalone BACKUP 


Standalone BACKUP is a subset of the OpenVMS Backup utility (BACKUP). 
Because you boot it into main memory, standalone BACKUP executes outside 
the control of the operating system. You use standalone BACKUP to restore the 
required save sets from the distribution media to your system disk. 


Standalone BACKUP is included in the OpenVMS VAX distribution kit. Each 
piece of media in the distribution kit has a label that indicates its contents. For 
example, there are two tape cartridges in a TK50 kit. Standalone BACKUP is on 
the second tape cartridge. 


3.2.1 Booting from Tape Cartridge 


If your distribution media is tape cartridges, complete the following steps to boot 
standalone BACKUP. (If you are using an InfoServer device, go to Section 3.2.2.) 


1. Place the media that contains standalone BACKUP in the source drive or in 
the console drive. 


2. Follow the instructions in the Booting Standalone BACKUP section of the 
upgrade and installation supplement for your VAX computer. 
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3. After you boot standalone BACKUP, the system displays the following: 


SBACKUP-I-IDENT, standalone BACKUP V6.2; the date is 22-NOV-1996 15:00 
$ | 


Note: If you have a tape cartridge kit, remove the tape cartridge 2/2 from the 
drive after you boot standalone BACKUP. Put the tape cartridge that contains 
the OpenVMS VAX operating system in the drive. The tape i is labeled 
VMS071 BIN TK50 1/2 VMS BINARY. 


After you have booted standalone BACKUP, go to Section 3.3. 


3.2.2 Booting from an InfoServer Device 
If you are using the InfoServer to boot standalone BACKUP from a comune disc, 
complete the following steps: 


1. Insert the distribution compact disc into the drive. 


2. Follow the instructions in the Booting Standalone BACKUP section of the 
upgrade and installation supplement for your VAX computer. 


3. Enter your VAX processor boot command by using the designator for the 
Ethernet adapter in the boot path and, except for the VAX 9000 computer, 
add the /R5:100 qualifier to the boot command. 


For example, on a VAX 6000 computer: 
>>> B/R5:100/X:D/B:6 ETO | 


On VAX 9000 computers, standalone BACKUP resides on the console hard 
disk. Because the boot process is slightly different for each type of controller, 
each supported controller has a unique boot command procedure. Refer to 
the upgrade and installation supplement for your VAX 9000 computer for . 
instructions for booting standalone BACKUP on your system. 


4, During an InfoServer boot, the procedure prompts you for a file name that 
contains an initial system load (ISL) boot program instead of a virtual 
memory boot (VMB) program. Select one of the two files as follows: 


e ISL_SVAX_071 
e ISL_LVAX_071 


Use the following table to determine which file name and boot path designator 
to use for your processor. Note that the VAX 9000 computer has the ISL file 
data built in its VMB image that runs from the console. 


Processor | 

Series ISL File - Boot Path Designator 

VAX 3000 ISL_SVAX_071 ESAO (LANCE), XQA0 (DELQA) 

VAX 4000 ISL_SVAX_071 EZAO (SGEC), XQA0 (DELQA) 

VAX 6000 — ISL_LVAX_071 EXAO (DEMNA), FXAO (DEMFA), 
ETAO (DEBNI) (DEBNA) 

VAX 7000 ISL_LVAX_071 EXA0 (DEMNA), FXA0O (DEMFA) 

VAX 10000 ISL_LVAX_071 EXA0 (DEMNA), FXAO (DEMFA) 

MicroVAX ISL_SVAX_071 ESAO (LANCE), XQA0 (DELQA) 


VAXstation ISL_SVAX 071 ESAO (LANCE) 
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Processor 
Series ISL File Boot Path Designator 
VAXft 110, 310, ISL_SVAX_071 EPAO (LANCE) 


410, 610, and 612 


On a VAX 6000 computer, you would respond to the prompt as shown in the 
following example: 


Loading system software. 


Filename: ISL LVAX 071 


The InfoServer ISL program then displays the following menu: 


Network Initial System Load Function 
Version 1.1 


FUNCTION FUNCTION 
ID 
1 Display Menu 
Help 
Choose Service 
Select Options — 


Stop 


On Wm G NR 
es es ee | 


Enter a function ID value: 
If you need more information, select function ID 2 for help. 
After you boot standalone BACKUP, the system displays the following: 


%BACKUP-I-IDENT, standalone BACKUP V6.2; the date is 22-NOV-1996 15:00 
S 


After you have booted standalone BACKUP, go to Section 3.3. | 


3.2.3 Booting OpenVMS from the CD-ROM 


If you are installing from the OpenVMS VAX operating system CD-ROM (your 
VAX computer supports booting from a local CD-ROM or from an InfoServer), 
you can use the full OpenVMS environment instead of the standalone BACKUP 
environment to transfer the VMS071.B save set to your target system disk. 
Although it may take slightly longer to boot OpenVMS than to boot standalone 
BACKUP, you might prefer the more robust OpenVMS environment. It provides 
a greater range of commands and utilities than the standalone BACKUP 
environment. | 


If you want to use the full OpenVMS environment, do the following: 


de; 


2. 


Boot the CD-ROM and specify root 1. For example, from a local drive on a 
VAXstation 4000 computer: 


>>> B/1000000 DKA400: 


If you are booting from an InfoServer device, enter a command that specifies 
root 1. For example, on a VAX 6000 computer: 


>>> B/R5:10000100/X:D/B:6 ETO 


After you boot the OpenVMS CD-ROM, the system displays the following 
menu: 


1) Execute DCL commands and procedures 
2) Shut down this system 


Choose option 1 to execute DCL commands and procedures. 
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Note that the system displays a triple dollar sign ($$$) DCL prompt to 
indicate that you are in this specialized DCL environment. 


3. Go to Section 3.3.3. 


3.3 Creating the System Disk 


You create an OpenVMS VAX Version 7.1 system disk by transferring OpenVMS 
VAX files from the distribution media to your system disk. (For certain files, you 
have the option to transfer the files to your system disk or to an alternate disk.) 


To transfer the OpenVMS VAX files from the distribution kit to your system disk, 
perform the steps described in the sections that follow. 


3.3.1 Step 1: Determine Device Names 


If you have not already done so, determine the device names for the source 
drive, the target drive, and an alternate device if you will be using one. Write 
these names on a piece of paper. You will need this information throughout the 
installation. If either the source drive or the target drive is connected to an HSC, 
you also need the name of the HSC. (To determine the value for hsc-name, see 
Section 2.4.3 in Chapter 2.) 


If you need more information about determining the device names for your 
system, refer to the upgrade and installation supplement for your VAX computer. 


3.3.2 Step 2: Load Distribution Media 


Each piece of media in the distribution kit has a label that indicates its contents. 
Place the media that contains the OpenVMS VAX operating system in the 
source-drive. 


If your OpenVMS VAX distribution kit consists of more than one piece of media, 
insert the first piece of media in the source-drive. For example, if you have a 
TK50 tape cartridge kit, make sure the first tape is in the source-drive. 


If you are installing from a compact disc, it is already in the drive. 


3.3.3 Step 3: Transfer VMS071.B to Your System Disk 
Enter a BACKUP command in the following format to transfer the VMS071.B 
save set to your system disk: 


$ BACKUP/IMAGE/VERIFY [hsc-name]source-drive: VMSO71. B/SAVE_SET- 
_$ [hsc-name]target-drive: 


Substitute the appropriate device names for hsc-name (if appropriate), source- 
drive, and target-drive. Make sure you put a colon (:) after each device name and 
that you use zeros rather than the letter “O” in the device names and in VMS071. 


The square brackets ([] ) indicate that you need the hsc-name only if the device is 
connected to an HSC. 


For example, if your system has a source-drive that is a local TU80 magnetic tape 
drive with a device name of MUAO and a target-drive that is an RA82 disk drive 

with a device name of DUAI1, enter the following command and press the Return 
key: 


$ BACKUP/IMAGE/VERIFY MUA0:VMS071.B/SAVE SET DUAL: 
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If your system has a source-drive that is a local tape cartridge drive with a device 
name of MUC6 or a target-drive that is an RA81 disk drive with a device name 
of DUA1 and an HSC name of YOURS, enter the following command and press 
Return: 


S$ BACKUP/IMAGE/VERIFY MUC6:VMS071.B/SAVE SET YOURSS$DUAI: 


The procedure transfers the VMS071.B save set from the distribution kit to the 
system disk.! The amount of time this takes varies depending on the type of VAX 
computer and distribution media you have. During the process, the command 
displays the following message: 


$BACKUP-I-STARTVERIFY, starting verification pass 


This message indicates that the VMS071.B save set has been transferred to 
the system disk and the files are being checked for errors. If, instead, you see 
a message similar to the following, you might have the wrong volume of the 
distribution kit in the source drive: 

% BACKUP-F-OPENIN, error opening MUA0:[000000]VMS071.B; as 


input 
- SYSTEM-W-NOSUCHFILE, no such file 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone BACKUP volume is online and ready. 
Enter "YES" to continue: 


If the procedure displays the previous messages, remove the distribution volume 
from the drive and replace it with the correct volume as described in Step 2. 
Then type Yes, press Return, and repeat this step. 


Completing the Transfer Operation 


Complete the transfer of the VMS071.B save set to your system disk by 
performing one of the following operations: 


e If you are using standalone BACKUP to transfer the VMS071.B save set, the 
procedure displays the following message, when it has completed checking 
files: 


SBACKUP-I-PROCDONE, Operation completed. Processing finished at 22-NOV-1996 15:00. 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 
Enter "YES" to continue: 


Enter NO and go to step 4 (Section 3.3.4) to boot the new system disk. 


e If you are using the specialized OpenVMS environment to transfer the 
VMS071.B save set, the system displays the triple dollar sign prompt ($$$) 
DCL prompt after the BACKUP operation completes. Enter the command 
LOGOUT to return to the menu. For example: 


$$$ LOGOUT 


1) Execute DCL commands and procedures 
2) Shut down this system 


1 The BACKUP command creates a system disk that includes a set of volume parameters 


provided by Digital, including CLUSTER_SIZE (disk access scheme). For more 
information, see the upgrade and installation supplement for your VAX computer. 
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You can then choose option 2 to shut down the system in preparation for 
booting the new system disk, as described in step 4 (Section 3.3.4). 


3.3.4 Step 4: Boot the New System Disk 


Halt the system and boot the new avatena disk, as described in the upgrade and 
installation supplement for your VAX computer. 


When the boot is completed, the procedure displays a message and prompts you 
to enter the date and time. Enter the date and time using the 24-hour clock 


format and press Return. 
For example: 


OpenVMS (TM) VAX Version 7.1 Major version id = 1 Minor version id = 0 
OpenVMS VAX V7.1 Installation Procedure 


Model: VAX 4000-300 
System device: RF73 - DUA8 
Free blocks: 1170940 
CPU type: 11-01 


* Please enter the date and time (DD-MMM-YYYY HH:MM):22-NOV-1996 15:35 


KREEKKEEKEKRREKEREKRKRERKKEEEKR ERE RE RKEREREKREE RK RRR EKER KKKREKEEE 
$SYSTEM-W-TZGMT, your local timezone has defaulted to GMT 
$SYSTEM-I-SETTZ, to set your local timezone use: 

S$ @SYSMANAGER:UCTSTIME SETUP.COM 


CECT CC CCCCCCCSCCC CCC CCCC SSCS L ELEC SSeS TCLS CLL eT ee eS Se 


STDRV-I-STARTUP, VMS startup begun at 22-NOV-1996 15:00:00.59 
$SET-I-NEWAUDSERV, identification of new audit server process is 00000028 


$33S%%3%S%S%3%% OPCOM 22-NOV-1996 15:00:15.46 %%%%3%%%3%%% 

Message from user JOB CONTROL on POKIPC 

SJBC-E-OPENERR, error opening SYSSCOMMON: [ SYSEXE ]QMANSMASTER. DAT 
$$%3%%%3%3%%3%% OPCOM 22-NOV-1996 15:00:15.41 %%33332 3338S 

Message from user JOB CONTROL on POKIPC 


-SYSTEM-W-NOSUCHFILE, no such file 


-LICENSE-F-EMTLDB, license database contains no license records 
SLICENSE-E-NOAUTH, DEC VAX-VMS use is not authorized on this node 
-$LICENSE-F-NOLICENSE, no license is active for this software product 
-SLICENSE-I- ~SYSMGR, please see oT system manager 

Startup processing continuing... 


sOrDRVat= STARTUP, VMS startup begun at 22-NOV-1996 15: 03:00.00 


Note 


~ You can ignore the time zone message. The UTC$TIME_SETUP.COM 
procedure runs during the final phase of the installation procedure. 


~The procedure also displays OPCOM messages from JOB_CONTROL stating the 
master queue file QMANS$MASTER. DAT does not exist. You can ignore these 
messages. You will create the queue file later. 


You can also ignore error messages stating that the OpenVMS VAX license is 
not registered. License registration occurs later in the procedure. For more 
information about registering your licenses, see Appendix B and the OpenVMS 
License Management Utility Manual. 
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3.3.5 Step 5: Specify the Volume Label 


The procedure prompts you to specify the volume label of the system disk. A 
volume label is the name the OpenVMS VAX operating system uses to refer to 
the system disk. You can press the Return key to accept the default volume label, 
OpenVMS071, or you can enter a volume label of your choice. The volume label 
can be 1 to 12 characters long; do not use spaces. For example: 


If this system disk is to be used in a cluster with multiple system 
disks, then each system disk must have a unique volume label. Any 
nodes having system disks with duplicate volume labels will fail to 
boot into the cluster. 


You can indicate a volume label of 1 to 12 characters in length. If you 
want to use the default name of OpenVMS071, press Return in response 
to the next question. 


* Enter the volume label for this system disk [OpenVMS071]: SYSDSK1 


3.3.6 Step 6: Specify the Source Drive 


The procedure prompts you to specify which drive holds the distribution kit. 
Enter the device name for the source drive. 


For example, if you are not using the InfoServer and the source drive is a 
magnetic tape drive with the device name MUAO, type MUAO and press Return. 


* Enter the name of the drive holding the OpenVMS distribution media: MUA0 
* Is the OpenVMS media ready to be mounted? [N] YES 

$MOUNT-I-MOUNTED, VMS071 mounted on MUAQ: 

If you are not using the InfoServer, continue to Section 3.3.7. 

If you are using an InfoServer, enter DAD1:. 


* Enter the volume label for this system disk [OpenVMS071]: SYSDSK1 
* Enter name of drive holding the OpenVMS distribution media: DAD1: 


The procedure then prompts you to: 


* Enter the InfoServer service name [VAXVMS071]: 
* Enter the InfoServer work group number [0]: 


Press the Return key as a response to both of these prompts. 


The InfoServer work group number was determined when you made a selection 
from the menu displayed by the InfoServer ISL program (refer to Section 3.2). If 
the answer to the group number is incorrect, the procedure displays the following: 


InfoServer work group number must be in the range 0-1023. 
The procedure then prompts you: 


* Is the OpenVMS media ready to be mounted? [N]: Y 
*MOUNT-I-MOUNTED, VMS071 mounted on DAD1: 


3.3.7 Step 7: Select Optional OpenVMS Components 


The procedure displays information about OpenVMS VAX files that are optional 
and about the remaining amount of disk space. The information is similar to the 
following (block sizes might vary slightly): 
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Select optional software you want to install. You can install one 
or more of the following OpenVMS or DECwindows components: 


OpenVMS library - 53400 blocks 
OpenVMS optional - 21200 blocks 
OpenVMS Help Message - blocks | 
OpenVMS Management Station | - 21200 blocks 
DECwindows base support - 3800 blocks 
DECwindows workstation support - 23500 blocks 
- 75 dots per inch video fonts - (included) 
- 100 dots per inch video fonts - 6000 blocks 


o DECnet-Plus networking - 85000 blocks 


OoOOoO0O00 0 


Space remaining on system disk: 1170752 blocks 


You must indicate which of the options you want to install. If you require network 
support, you must select the OpenVMS library component. 


Note that, if you do not install the optional components at this time, you can 
install them after the installation by using the VMSTAILOR or DECW$TAILOR 
utility. However, the Help Message utility can be tailored on to the system disk 
only. 


If you want to install Help Message on an alternate disk, you must install it now 
or install it after the installation procedure completes by entering the following 
BACKUP command: 


BACKUP/VERIFY source-device:[000000]VMS071.E/SAVE SET - 
_target-device: [directory-name] 


For source-device, enter the device name for the drive on which the distribution 
media is mounted. For target-device, enter the device name on which the 
alternate disk is mounted, and for directory-name, enter the name of the directory 
to which you are copying the files. 


Also note that, for TK50 tape cartridges, it is quicker to install OpenVMS VAX 
software during the installation than to add software after the installation with a 
tailoring utility. For information about using VMSTAILOR, see Chapter 10. 


To select the options you want to install, follow the instructions displayed by the 
procedure. : 


3.3.7.1 OpenVMS Library Files 
The procedure displays the following message: 
* Do you want to install the OpenVMS library files? (Y/N) 


The file subclasses of the VMS071.C save set are listed in Appendix D. If you 
want to install the VMS071.C files, type Y (for YES) and press Return. If you 
require network support, you must select the OpenVMS library component. If 
you do not want to install the VMS071.C files, type N (for NO) and press Return. 


3.3.7.2 OpenVMS Optional Files 
The procedure displays the following message: 
* Do you want to install the OpenVMS optional files? (Y/N) 


The file subclasses of the VMS071.D save set are listed in Appendix D. If you 
want to install the VMS071.D files, type Y and press Return. If you do not want 
to install the VMS071.D files, type N and press Return. 
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3.3.7.3 Help Message Files 
The procedure displays the following message: 


The Help Message utility (MSGHLP) provides online explanations 
and user actions for OpenVMS messages in place of the hardcopy 
OpenVMS System Messages and Recovery Procedures Reference Manual, 
which is now separately orderable. 


The MSGHLP database, MSGHLPSLIBRARY.MSGHLPSDATA, 

consumes approximately 10200 blocks and will be 

placed by default on your system disk in SYSSCOMMON: [SYSHLP ] 
unless you specify an alternate device when prompted. 


Users with limited disk space can access the MSGHLP database 
on a read-only basis at DAD1:[HELP MESSAGE]. 


* Do you want to install the MSGHLP database? (Y/N) 


The Help Message utility is an online system for system messages documentation. 
You can install Help Message either on the system disk or on an alternate disk. 
If you want to install the Help Message files, type Y and press Return. 


The procedure displays the following message: 


You can install this database on your system disk in SYSSCOMMON: [SYSHLP ] 
or on an alternate device. If you specify an alternate device, but no 
directory, MSGHLPSLIBRARY.MSGHLPSDATA is placed in [HELP MESSAGE]. When 
prompted, take the default of the system disk or specify | an alternate 
device, using this format: 


device: [directory ] 


* Where do you want to install the MSGHLP database?[SYSSCOMMON:[SYSHLP]] DUA1 


The Help Message database is installed in the area you specify, and the system 
displays information similar to the following: 


Space remaining on alternate device DUAI1: 124532 blocks 


3.3.7.4 OpenVMS Management Station Files 
The procedure displays the following message: 


The OpenVMS Management Station is a client-server application 
that provides OpenVMS system management capabilities through a 
client application on a personal computer (PC) running Microsoft 
Windows. The server application runs on OpenVMS systems and is 
automatically installed as part of the OpenVMS operating system. 


This option provides the files used to create the installation media 
for the PC client software. If you want to use the OpenVMS Management 
Station, you must install these files on at least one OpenVMS system to 
create the installation media, which can then be used to install the 

PC client on one or more PCs. 


Note: To use the OpenVMS Management Station on your PC, you must be 
running Digital’s PATHWORKS V5.0A for DOS and Windows (or V5.1) 
software. 


The OpenVMS Management Station optional files consume approximately 212000 
blocks and will be placed on your system disk in SYSSCOMMON:[TNT.CLIENT]. 


* Do you want to install the optional OpenVMS Management Station files? (Y/N) 
Space remaining on system disk: 623240 blocks 
_If you want to use the OpenVMS Management Station software, you must install 
these files. After the installation procedure completes, follow the instructions in 


Appendix G to prepare your OpenVMS system and your a, to run the OpenVMS 
Management Station server and client software. 
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3.3.8 Step 8: Choose DECwindows Support Options 


Next, the procedure displays messages about the DECwindows components 
shipped with OpenVMS VAX Version 7.1. 


Note 


The OpenVMS VAX operating system no longer ships the VMS 
DECwindows product. The operating system now ships only the 
DECwindows base support and DECwindows workstation support 
components. To get full DECwindows support, you must also install — 
the separate DECwindows Motif for OpenVMS (previously called VMS 
DECwindows Motif) layered product, which supports both Motif and XUI 


environments. 


The DECwindows base support and DECwindows workstation 
support components are not shipped with the layered product. If you 
want to install these options, you must select them now or use the 
DECWSTAILOR option after the installation procedure completes. 


Before you indicate whether you want to install DECwindows support software, 


consider the following: 


if you... 
Intend to install the DECwindows Motif 
layered product 


Intend to install the DECwindows Motif 
layered product on a workstation or on a 


VAXcluster system that contains workstations 


Are not planning to install the DECwindows 
Motif layered product but are installing 
OpenVMS VAX on a workstation or on a 
VAXcluster that includes workstations 


Want to provide font files for X terminals 


Have a workstation monitor (for example, 
a VR150, VR160, or VR295) capable of 
displaying 100 dots/inch or a VAXstation 
4000 series computer, which uses 100 dots 
/inch video fonts by default 


The procedure displays the following: 


Then choose... 


DECwindows base support. 


DECwindows base support and 
DECwindows workstation support. 


DECwindows base support and 
DECwindows workstation support. 


DECwindows base support and 
DECwindows workstation support. 


DECwindows base support and 
DECwindows workstation support with 
the 100 dots/inch option. 


By selecting the workstation support 
files, you automatically get 75 dots/inch 
video font files, and you will be prompted 
to indicate if you want to install 100 | 
dots/inch video font files. 


You can select DECwindows support now, or you can use the DECWSTAILOR utility 
to provide or remove DECwindows support after the installation. 


Some media, TK50s in particular, can be very slow when tailoring on files. 
You might want to provide DECwindows options now and tailor off unwanted files later. 


NOTE: This kit does NOT contain full DECwindows. 
To obtain full DECwindows support, you must also install the 
separate layered product, DECwindows Motif for OpenVMS VAX. 
Version 1.2-3 is the minimum version of DECwindows Motif for OpenVMS VAX 
that can be used with OpenVMS VAX Version 7.1. 


The DECwindows components provided in this kit require approximately 


33300 blocks, broken down as follows: 
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o DECwindows base support - 3800 blocks 
o DECwindows workstation support - 23500 blocks 
- 75 dots per inch video fonts (included) 
- 100 dots per inch video fonts (optional) - 6000 blocks 


You must select the DECwindows base support option if 
- you plan to run DECwindows software, or 
- you are installing this kit on 
* a workstation or 
* a VAXcluster that contains workstations, or 
- you want to provide font files for Xterminals. 


If you are installing this kit on a system that includes Xterminals 
and you do not select DECwindows base support, then you will have to use 
the DECWSTAILOR utility to provide font files. 


* Do you want the DECwindows base support? (Y/N) 
Space remaining: 612725 


You must select the DECwindows workstation support option if 
- you are installing this kit on 
* a workstation or 
* a VAXcluster that contains workstations, or 
~ you want to provide font files for Xterminals. 


If you are installing this kit on a system that includes Xterminals 
and you do not select DECwindows base support, then you will have to use 
the DECWSTAILOR utility to provide font files. 


* Do you want to provide DECwindows workstation support? (Y/N) 
Space remaining: 591975 
DECwindows workstation support includes the 75 dots per inch video fonts. 


All DECwindows applications run with 75 dots per inch video fonts. 
By default, most systems start up with 75 dots per inch video fonts. 
Certain applications can take advantage of 100 dots per inch video fonts. 


For the VAXstation 4000 series machine, 100 dots per inch video fonts 
are used by default. If you decide not to install 100 dots per inch 

video fonts, you must edit SYSSMANAGER:DECWSPRIVATE SERVER _SETUP.COM 
to force 75 dots per inch video fonts to be the default. Otherwise, 

certain applications may not space text properly. 


For instructions on how to configure your system with both 75 and 100 
dots per inch video fonts, see the template command procedure 
SYSSMANAGER: DECWSPRIVATE SERVER SETUP . TEMPLATE. 


*Do you want 100 dots per inch video fonts installed? (Y/N) 


Space remaining: 541975 


3.3.9 Step 9: Select DECnet Product 


Next, the procedure displays messages describing the DECnet options. For more 
information, refer to Section 1.2.1. 


Beginning with OpenVMS V7.1 DECnet-Plus is provided with the OpenVMS 
operating system. Digital strongly recommends that DECnet users 
install DECnet-Plus. DECnet Phase IV applications are supported 

by DECnet-Plus. 


If you plan to install DECnet Phase IV do NOT select DECnet-Plus. 
* Do you want to install DECnet-Plus. (Y/N) Y 
Space remaining on system disk: 456975 blocks 


If you want to install DECnet Phase IV, you must do so after the OpenVMS VAX 
installation procedure completes. 
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3.3.10 Step 10: Verify Your Choices 


The procedure displays a list of OpenVMS VAX and DECwindows support options 
you have selected and gives you the opportunity to change your mind before 
proceeding by displaying the following message: 


* Is this correct? (Y/N) 


If you answer No to this prompt, you ca 
DECwindows support options you want t 


3.3.11 Step 11: Install OpenVMS Options 


If you answer Yes to the prompt in step 9, the installation procedure begins 
restoring the OpenVMS options you have selected. After the installation has 
completed, you can use the VMSTAILOR utility to remove any optional OpenVMS 
files that you do not need. (For more information about using VMSTAILOR, see 
Chapter 10.) 
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This step in the procedure will vary, depending on whether your distribution kit 
is on compact disc, tape cartridges, or magnetic tapes. 


3.3.11.1 Compact Disc 


If your distribution kit is on compact disc, leave the disc in the drive. The 
procedure displays messages as it restores each of the OpenVMS options you 
have chosen to install. , 


3.3.11.2 Tape Cartridges and 9-Track Open Reel Magnetic Tapes 


If your distribution kit is on TK50 tape cartidges or 9-track open reel magnetic 
tapes, you may be asked to mount additional volumes of the kit. In such a case, 
your system will display a message similar to the following: 


Please mount volume <x> of the OpenVMS kit on <device> 


where: <x> is the volume number and <device> is the cartridge tape drive or 
open reel tape drive. 


After you respond to the prompt, the system displays one of the following 
messages: 


e For a TK50 tape cartidge, the message is similar to the following: 
* Is the volume labeled OVMS VAX V7.1 BIN TK50 2/2 ready to be mounted? 

e For 9-track open reel tape, the message is similar to the following: 
* Is the volume labeled OVMS VAX V7.1 BIN MT9 n/4 ready to be mounted? 
where: n/4 may be 2/4, 3/4 or 4/4. 

To respond to either message, do the following: 

1. Unload the volume currently in the drive. 


2. Examine the remaining volumes and select the one with the label that 
matches the label specified in the prompt. 


3. Load the volume and make the drive ready. 
4. Answer YES to the question. 


For information on which save sets are located on which tape volumes, 
Section 1.4.1 and Section 1.4.2. 
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Step 12: Install DECwindows Support Software 


If you are installing DECwindows software, the procedure installs the 
DECwindows options that you specified and displays messages similar to the 
following: 


Restoring DECwindows base support save set ... 
$BACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows workstation support save set ... 
$BACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows 75 dots per inch fonts save set ... 
$BACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows 100 dots per inch fonts save set ... 
$BACKUP-I-STARTVERIFY, starting verification pass 


The DECwindows support files are listed in Appendix E. After you finish the 
installation, you can use the DECwindows tailoring utility, DECW$TAILOR, 
to remove the DECwindows files you do not need. For more information about 
removing files with DECW$TAILOR, see Chapter 10. 


If your distribution media is tape cartridges or magnetic tape, the procedure 
displays a message similar to the following after the DECwindows options you 
have selected have been successfully installed: 


You can now remove the DECwindows distribution kit from MUA0:. 
Remove the distribution media from the drive. 


If your distribution media is compact disc leave it in the drive. 


3.4 Configuring a Cluster 


The installation procedure now displays information about cluster configuration. 
But, because there is no network present on the system at this point in the 
procedure, no cluster configuration work can actually be performed at this time. 


In a cluster, you can run multiple systems sharing all files except 
PAGEFILE.SYS, SWAPFILE.SYS, SYSDUMP.DMP, and VAXVMSSYS.PAR. 


Cluster configuration cannot be done at this time because no network 
is present. In order to configure a cluster, you must FIRST do one 
or both of the following: 


o Install DECnet-Plus (or DECnet Phase IV), or 
o Execute SYSSSTARTUP:LANS$STARTUP.COM by removing the 
comment delimiter ("!") from the line 


$1 @ SYS$STARTUP:LANSSTARTUP.COM 
in SYSSMANAGER:SYSTARTUP VMS.COM. 
Then configure the cluster by executing the following command: 
@SYSSMANAGER:CLUSTER_ CONFIG.COM 
Once the network is running on your system, you can execute the 
SYSSMANAGER:CLUSTER_CONFIG.COM command procedure in configure 


your cluster. For more information about cluster configuration, see the OpenVMS 
System Manager’s Manual: Essentials. 
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3.5 Setting Passwords 


Next, the installation procedure prompts you to set passwords for the SYSTEM, 
SYSTEST, and FIELD accounts and uses this information to create a rights 
database. | 


When setting the passwords, remember: 

e Passwords must be 8 characters or more. 

e Passwords are not displayed by the system while you are entering them. 
e Press Return after you enter each password. 

e Each password is verified. 

Use the following procedure to set passwords: 


1. Supply the passwords when prompted by the installation procedure, as 
| follows: 


Now we will ask you for new passwords for the following accounts: 
SYSTEM, SYSTEST, FIELD | 


Passwords must be a minimum of 8 characters in length. All passwords 
will be checked and verified. Any passwords that can be guessed easily 
will not be accepted. 


* Enter password for SYSTEM: 

* Re-enter for verification: 

SUAF-I-MDFYMSG, user record(s) updated 

%VMS-I-PWD OKAY, account password for SYSTEM verified 


* Enter password for SYSTEST: 

* Re-enter for verification: 

SUAF-I-MDFYMSG, user record(s) updated 

%VMS-I-PWD OKAY, account password for SYSTEST verified 


The SYSTEST CLIG account will be disabled. You must re-enable 
it before running UETP but do not assign a password. 


* Enter password for FIELD: 

* Re-enter for verification: 

SUAF-I-MDFYMSG, user record(s) updated 

sVMS-I-PWD OKAY, account password for FIELD verified 


2. If there are no password errors, the procedure creates your rights database, 
and you can proceed to the next section. 


If you enter a password incorrectly or if the password is too easy to guess, the 
procedure displays error messages similar to the following: 


SVMS-I-PWD INVALID, account password for SYSTEST is invalid 
%VMS-I-PWD WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure this account. 
You must either disable this account, change its password, or do both. 


3. When the procedure asks if you want to disable the account, type N and press 
Return. When the procedure asks if you want to enter a new password, type 
Y and press Return. Then enter a new password. For example: 


Do you want to disable this account (Y/N)? N 

Do you want to change the account password (Y/N)? Y 

You must now select a new primary password for the SYSTEST account. The 
password you select must be at least 8 characters in length and cannot 
be the same as the name of the account: 
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New password: 

Verification: 

$UAF-I-MDFYMSG, user record(s) updated 

$VMS-I-PWD SET, primary password for account SYSTEST set 


4. When you have successfully set the passwords, the installation procedure 
creates your rights database, which lets you manage user access to the 
system, and displays the following message: 


Creating RIGHTS database file, SYSS$SYSTEM:RIGHTSLIST.DAT 
Ignore any "-SYSTEM-F-DUPIDENT, duplicate identifier" errors 


3.6 Entering SCSNODE and SCSSYSTEMID Parameters 


If you are installing a standalone system, the procedure displays the following 
prompts: 


* Please enter SCSNODE name 


* Please enter SCSSYSTEMID 


Enter the SCSNODE name and SCSSYSTEMID that you determined as part of 
the preinstallation tasks in Chapter 2. 


If you are installing the operating system in a VAXcluster environment, you 
are not prompted to supply these parameters. The procedure calculates these 
parameters using the DECnet node name and node address you supplied earlier 
in the procedure. 


3.7 Postinstallation Tasks Described 


After the procedure creates the rights database, it displays messages describing 
postinstallation tasks you might want to perform. 


Note that you do not perform these tasks now but after the installation completes. 


The tasks displayed on your screen might vary from the following example, 
depending on what options you chose to install earlier in the procedure. 


After the installation finishes, you might want to do one or more of the 
following tasks: 


o DECOMPRESS THE SYSTEM LIBRARIES - To save space, many of the system 
libraries are shipped in a data-compressed format. If you have 
enough disk space, you can decompress the libraries oe faster access. 
To data expand the libraries, type: 


$ @SYSSUPDATE: LIBDECOMP.COM 


If you do not decompress these libraries, you will experience slower 
response with the HELP and LINK commands. 


o BUILD A STANDALONE BACKUP KIT - You can build a standalone backup kit 
using the procedure described in the upgrade and installation supplement 
supplied for your VAX computer. 


oO TAILOR THE SYSTEM DISK - You might want to review the files provided or 
not provided during this installation. If you find there are files 

you want to remove from the system disk (TAILOR OFF) or files you want 

to add (TAILOR ON), use the following utilities to perform the 

desired tailoring. 


OpenVMS tailoring: $ RUN SYSSUPDATE: VMSTAILOR 
DECwindows tailoring: $ RUN SYSSUPDATE: DECWSTAILOR 
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Note: The tailor procedure cannot be used to TAILOR ON or to TAILOR OFF 
files located onan alternate device. 


o DEFINE A LOGICAL NAME - Define the logical name ceeee in 
your site-specific startup file to be: DUA1:[HELP MESSAGE] to 
point to the new location of the MSGHLP database. 


For more information about decompressing the system libraries, see Section 4.8 


in Chapter 4. For information on using VMSTAILOR or DECW$TAILOR, see 


Chapter 10. 


After the messages about postinstallation tasks are displayed, the procedure 
displays a message similar to the following: 


Continuing with OpenVMS VAX V7.1 installation procedure. 


Configuring all devices on the system... 


Proceed to the next section for information about registering your licenses. 


3.8 Registering Licenses 


Before you can use the OpenVMS VAX operating system and its components, you 
must first register all licenses. If you do not register your licenses at this point in 
the procedure, you must register them immediately after the installation, before 
you perform the other postinstallation tasks. | 7 


3.8.1 Types of Licenses 


The OpenVMS VAX operating system uses one of two different categories 
of licenses, depending on the hardware and software configuration used 


and currently supported. The two categories of operating system licenses for 
OpenVMS VAX are: 


e VAX VMS licensing _ 
e OpenVMS VAX licensing 


_ The following table describes the types of licenses for each licensing category. 


Type of License 


Digital provides the proper license type with the purchase of the system. Not all 
license types are available for every system model. 


Description 


VAX VMS Licenses 


Traditional License Provides unlimited use to the users on a defined system. VAX VMS 


traditional licenses are sized to capacity according to system type. 


Multi-User License Provides use according to a specified number of concurrent users. This 


is an activity-based license. The Multi-user License gives you the right 
to use the operating system for up to the limit of users specified in the 
license. An operating system user is one who is logged in to the system 
or one who is using the operating system software by means other than 
login, or both. This license is available only on limited system models, 
primarily MicroVAX and VAX 4000 systems. 


Interactive use of VAX systems licensed with the Multi-user License 
can be increased by the addition of the OpenVMS VAX Individual User 
License’ for one or more users. For more information, refer to the 
description of the OpenVMS VAX Individual User License later in this 
table. 


‘The OpenVMS VAX Individual User License is not supported by the VMS or OpenVMS VAX operating system releases 
prior to VMS Version 5.5. 
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Type of License Description 


VAX VMS Licenses 


VAX VMS Workstation License Provides use for a single user on a VAX workstation. This license type 
allows one direct login for the single user and then one additional login 
for system management purposes only. 


Additional interactive use of VAX workstations licensed with the VAX 
VMS Workstation License requires the addition of an OpenVMS VAX 
User License! for one or more users. For more information, refer to the 
description of the OpenVMS VAX Individual User License later in this 


table. 
File and Application Server Provides for the noninteractive use of OpenVMS VAX. OpenVMS based 
License VAXservers are sold with a File and Application Server License. 


The intent of an OpenVMS based VAXserver is to provide file, print, 
application, and compute services to clients who have remotely 
submitted their requests for these services. This license type also 
allows one direct login for system management purposes only. 


Additional interactive use of OpenVMS VAXservers licensed with 
the File and Application Server License requires the addition of 

an OpenVMS VAX User License’ for one or more users. For more 
information, refer to the description of the OpenVMS VAX Individual 
User License later in this table. 


OpenVMS VAX Licenses 


OpenVMS VAX O/S Base Provides the right to unrestricted, noninteractive use of the OpenVMS 

License” VAX operating system for the execution of remotely submitted requests 
for batch, print, application, and computing services, on a designated, 
single processor. 


No direct OpenVMS VAX operating system logins by users are 
permitted on the system. One direct login is allowed for system 
management purposes only. 


Interactive use of systems licensed with an OpenVMS VAX O/S Base 
License requires the addition of an OpenVMS VAX Individual User 
License! for one or more users. 


OpenVMS VAX Individual User Provides the right to interactively use the operating system by a 

License? specified, or unlimited, number of concurrent users on a designated, 
single processor. A user is one who is logged in to a processor or one 
who is interactively using the operating system software by means 
other than login, or both. An OpenVMS VAX O/S Base License, or 
any of the four types of VAX VMS Licenses, is a prerequisite for the 
OpenVMS VAX Individual User License. | 


1The OpenVMS VAX Individual User License is not supported by the VMS or OpenVMS VAX operating system releases 
prior to VMS Version 5.5. 


2The OpenVMS VAX O/S Base License is not supported by the VMS or OpenVMS VAX operating system releases prior to 
VMS Version 5.5. | 


3.8.2 How to Register Your Licenses 


You must register your licenses in the following order: 


1. Register the OpenVMS VAX license for the VAX computer on which you have 
just installed the operating system. If you have a VAXcluster environment, 
you then register an OpenVMS VAX license for each additional VAX computer 
in the cluster that will boot off the system disk that you just created. Each 
registered OpenVMS VAX license must be assigned to one of the nodes for the 
cluster. 
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2. Register the licenses for any System Integrated Products (SIPs) that you 
purchased. 


For more information about registering licenses, see the following: 
¢ OpenVMS License Management Utility Manual, which provides: 


— Details about all LICENSE commands, error messages, and recovery 
procedures for licensing tasks 


— A description of VMSLICENSE.COM, with step-by-step instructions for | 
registering licenses 


— Examples of license registration using VMSLICENSE.COM — LICENSE 
REGISTER commands 


e Appendix B of this manual for notes and supplemental information concerning 
licenses 


You can use the SYS$UPDATE:VMSLICENSE.COM procedure to register a 
license for any Digital product that supplies a Product Authorization Key (PAK). 
Or, you can register licenses with the LICENSE REGISTER command. See the 
OpenVMS License Management Utility Manual for detailed information. 


3.8.2.1 How to Register OpenVMS VAX Licenses 
The installation procedure displays the faliowing message: 


If you have any Product Authorization Keys (PAKS) to register, you can 
register them now. | 


* Do you want to register any Product Authorization Keys? (Y/N) 


If you choose ... Then ... 
Not to register the licenses at this Do the following: 
time 
1. Type N and press Return. 
2. Go to Section 3.11. 
3. Remember that, after the installation, you must register 
your licenses before performing any other postinstallation 
tasks (see Chapter 4). 
To register your licenses now Do the following: 


1. Type Y and press Return. 


2. Besure you have a copy of your PAK for each license you 
will register. 


3. Go to the next section to begin the licensing procedure. 


By typing Y (Yes) to register your licenses now, you invoke the 
SYS$UPDATE:VMSLICENSE.COM procedure, which displays the following 
message: | 
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OpenVMS License Management Utility Options: 


1. REGISTER a Product Authorization Key 

2. AMEND an existing Product Authorization Key 
3. CANCEL an existing Product Authorization Key 
4. LIST Product Authorization Keys 

5. MODIFY an existing Product Authorization Key 
6. DISABLE an existing Product Authorization Key 
7. DELETE an existing Product Authorization Key 
8. COPY an existing Product Authorization Key 
9. MOVE an existing Product Authorization Key 
10. ENABLE an existing Product Authorization Key 
11. SHOW the licenses loaded on this node 

12. SHOW the unit requirements for this node 


99. Exit this procedure 


Type ‘?’ at any prompt for a description of the information 
requested. Press Ctrl/Z at any prompt to return to this menu. 


Enter one of the above choices [1] 


Select the appropriate options (beginning with 1, as shown) until you have 
successfully registered all required PAKs. 


3.8.2.2 How to Register System Integrated Products 


After you register the OpenVMS VAX license, you must register the license for 
any of the following System Integrated Products (SIPs) you have purchased: 


VAXcluster 
(LMF Product Name: VAXCLUSTER) 


DECnet—Plus 


There are two DECnet—Plus licenses: 
— The end node license named DVNETEND 
— The routing node license named DVNETRTG 


All routing nodes must have a routing license. Each end node can have 
either an end node license or a routing license. If neither license is 
registered and activated, DECnet does not start and your use is limited 
to local DECnet only (SET HOST 0). If DECnet—Plus for OpenVMS is 

- running when you register your license, you must stop and then restart it. 


You can control which VAXcluster nodes have access to each license. 
Using the LICENSE MODIFY/INCLUDE=(node-name[,node-name.,...]) 
command, you can assign licenses to nodes and limit access as needed. 
For example, you can assign a routing node license to only one VAXcluster 
node and assign the end node licenses to the remaining VAXcluster nodes. 
If you choose this approach, make sure you assign a license to each end 
node license. Specify include lists for each license of the same type. For 
details, see the OpenVMS License Management Utility Manual. 


RMS Journaling for OpenVMS 
(LMF Product Name: RMSJNL) 


On systems that do not have registered and loaded journaling licenses, users 
cannot write to any files marked for journaling. 


Volume Shadowing for OpenVMS 
(LMF Product Name: VOLSHAD) 


You must register and load a license for Volume Shadowing for OpenVMS 
on each node using volume shadowing, including satellites in a VAXcluster 
system. 
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3.9 Time Zone and Time Differential Factor Information 


At this point in the installation, the procedure asks you for time zone information 
that is used for providing local time zone support. 


3.9.1 Updating Time Zone Information 


For local time zone support to work correctly, the installation procedure must set 

the time zone that, accurately describes the location you want to be considered 

as your default time zone. Usually, this is the time zone in which your system 

is running. In addition, your system must be correctly configured to use a valid 
OpenVMS time differential factor (TDF). 


The procedure displays a series of time zone menus and prompts you to tele 
selections from those menus. The first menu is the main time zone menu. Select 
the time zone that best describes your location. If you do not select a time zone, 
the default is Greenwich Mean Time (GMT). | 


Some time zone choices cause an additional menu to be displayed. This happens 
when the time zone you select has subcomponents. For example, if you choose the 
United States (US) time zone from the main menu, a second menu displays the 
specific time zones within the United States. You then select the menu item that 
best represents your local time zone. 


The procedure then prompts you for the TDF. The TDF is the difference 
between your system time and Coordinated Universal Time (UTC), which is 
an international standard for measuring time of day. You can choose from the 
following options: 


e Exit the time zone procedure without setting a TDF 
e Set a TDF | 
e Display the TDF for your local time zone 


For more information about TDF and local time zone eupeere see the OpenVMS 
System Manager’s Manual 


If you chose to install DECnet—Plus earlier in the installation procedure, see 
Section 3.10. 


If you chose not to install DECnet—Plus, go to Section 3.11. 


3.10 Installing DECnet—Plus 


Earlier in the procedure, you were asked whether you wanted to install the 
DECnet—Plus product. If you answered Yes, the procedure will now install the 
DECnet—Plus product. 


The procedure displays a message similar to the following and prompts you for 
information it needs to install the DECnet—Plus product. In this example, the kit 
is being installed from an InfoServer device, DAD1. 

DECnet-Plus will now be installed. 

Media containing the DECnet-Plus kit must be available. 


If you are installing OpenVMS. from an InfoServer (DAD1) 
or local CD-ROM, there is a DECnet-Plus kit on the CD-ROM. 


If you are installing from a cartridge tape (TK50) or 
from an open reel tape, you should have a DECnet-Plus kit 
on cartidge tape or open reel tape. 
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An appropriate DECnet-Plus kit may also be available on 
the Consolidated Distribution CD-ROM, or you may have a 
separate DECnet-Plus kit. 


NOTE: You may choose any available media for the 
DECnet-Plus kit. It is NOT NECESSARY to use the same 
type of media that contained the OpenVMS kit. 


If you do not have a DECnet-Plus kit available, or if you 
have decided NOT to install/upgrade DECnet-Plus, you can 
bypass the DECnet-Plus installation by entering "EXIT" 
for the "name of drive holding the DECnet-Plus kit". 


* Enter name of drive holding the DECnet-Plus kit: DAD1: 
* Enter the InfoServer service name: OTHER PRODS 
* Enter the InfoServer work group number [0]: 


The following product has been selected: 
DEC VAXVMS DECNET OSI V7.1 
DEC VAXVMS DECNET OSI V7.1: DECnet-Plus V7.1 for OpenVMS VAX 
Copyright © Digital Equipment Corporation 1996. All rights reserved. 
Digital Equipment Corporation 
This product requires one of two PAKs: DVNETEND or DVNETRTG. 
Do you want all the default values for this product? [YES] 
Do you want to view the values? [NO] 


Execution phase starting ... 
The following product will be installed: 
DEC VAXVMS DECNET OSI. V7.1 
Portion done: 0%...10%...20%...30%...40%...80%...90%...100? 
The following product has been installed: 
DEC VAXVMS DECNET OSI V7.1 


To complete the installation procedure, continue on to the next section, 
Section 3.11. 


3.11 Running AUTOGEN 


The remaining portion of the installation procedure runs AUTOGEN to evaluate 

your hardware configuration and estimate typical workloads. AUTOGEN then 

sets system parameters, the sizes of page, swap, and dump files, and the contents 

of VMSIMAGES.DAT. When AUTOGEN finishes and the system has rebooted, 
the installation procedure is complete. 


The installation procedure runs AUTOGEN, as follows: 


1. The installation procedure displays a series of messages similar to the 
following: 


Running AUTOGEN to compute new SYSTEM parameters ... 


SAUTOGEN-I-BEGIN, GETDATA phase is beginning. 

SAUTOGEN-I-NEWFILE, A new version of SYSSSYSTEM:PARAMS.DAT has been created. 
You may wish to purge this file. 

tAUTOGEN-I-END, GETDATA phase has successfully completed. 


SAUTOGEN-I-BEGIN, REBOOT phase is beginning. 


If you need to create or modify the size of the pagefile or swapfile, use the 
SYSMAN utility. For more information, see the OpenVMS System Manager's 
Manual: Essentials. 
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2. After AUTOGEN finishes, the procedure displays a series of shutdown 
messages that begin like this: 


The system is shutting down to allow the system to boot with the 
generated site-specific parameters and installed images. 


The system will automatically reboot after the shutdown and the 
upgrade will be complete. 


SHUTDOWN -- Perform an Orderly System Shutdown 


3. After the system shuts down, the procedure tries to reboot the new system 
disk. If the system does not reboot automatically, reboot it manually. 


For example, suppose you have a VAX—11/780 computer and the system disk | 
is on an RA6O disk drive with a unit number of one. Enter the following 
command and press Return: 


>>> B DUAL 


For information on booting, refer to the upgrade and installation supplement 
for your VAX computer. Then return to this manual. 


4. After the system reboots, the procedure displays the following message: 


“OpenVMS VAX Version V7.1 Major version id = 1 Minor version id = 0 


KEKE REE RRR RRR KK REE RRR RRR RRR RK ERERRRKKERRRKEEES 
OpenVMS VAX V7.1 
You have SUCCESSFULLY installed the OpenVMS VAX operating system. 


The system is now executing the STARTUP procedure. Please 
wait for the completion of STARTUP before logging in to the 
system. 


KREKREKREKERER ERR RRR REE RR ERR ERE ERR RRR RRR RRR RERERERERERKEEREREEKS 


Note: If you did not register your OpenVMS VAX license as described in 
Section 3.8, the procedure displays warning messages that the OpenVMS 
license must be registered. Be sure to register this license when the 
installation procedure finishes. For more information, see Appendix B and 
the OpenVMS License Management Utility Manual. 


Finally, the procedure displays informational messages and accounting 
information. For example: 


$SET-I-INTSET, login interactive limit = 64, current interactive value = 0 


SYSTEM job terminated at 22-NOV-1996 16:54:24.71 
Accounting information: 
Buffered I/0 count: 859 Peak working set size: 565 
Direct I/O count: 478 Peak virtual size: 2570 
Page faults: 5003 Mounted volumes: i 
Charged CPU time: 0 00:00:19.33 Elapsed time: 0 00:00:41.24 


At this point the OpenVMS VAX operating system is running. 


5. Press the Return key. The system asks you for the user name and password. 
Log in to the SYSTEM account so you can perform certain postinstallation 
tasks. For example: 


Welcome to OpenVMS VAX V7.1 


Username: SYSTEM 
Password: 


Welcome to OpenVMS VAX Version V7.1 
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If you forget the password, follow the instructions for performing an 
emergency startup in the OpenVMS System Manager’s Manual: Essentials. 


There are several postinstallation tasks you must perform before you can use 
the system. These tasks are described in Chapter 4. 
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4.1 Overview 


After you have installed the OpenVMS VAX operating system, you need to 
perform several important tasks to prepare the system for operation. This 
chapter describes the following postinstallation tasks in the order you perform 
them: 


e Verifying system time 

e §6Registering licenses 

e Backing up your system disk 

e Customizing your system 

e Configuring and starting networking software 
e Testing the system 

e Decompressing system libraries 

e Removing unwanted files 

e Installing layered products 

e Backing up the customized system disk 
e Running AUTOGEN 

e Completing the postinstallation checklist 


If you are an experienced system manager, you can use the checklist at the end of 
the chapter to complete the necessary postinstallation tasks. 


If you are a system manager with less OpenVMS VAX experience, you should 
read the entire chapter and then use the checklist to make sure you have 
completed all the postinstallation tasks. 


4.2 Verifying System Time 


During the installation, the procedure prompted you to enter the date and time. 
Now that you have installed your system, verify that the system time is correct 
by entering the following command: 


$ SHOW TIME 


The system displays the date and time. If the time is not correct, reset it by 
entering the command SET TIME using the following format: 


SET TIME=dd-mmm-yyyy:hh:mm:ss 
For example: 


$ SET TIME=22-NOV-1996:18:35:30 
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4.3 Registering Your Licenses 


The installation procedure gave you the opportunity to register any software 
product licenses. If you did not register your OpenVMS VAX license at that 
time, you must do so before you can use the OpenVMS VAX operating system. 
You must also register the licenses for any of the following System Integrated 
Products you have purchased: 


VAXcluster — 

~DECnet—Plus 

OpenVMS RMS J saviaiiage 
Volume Shadowing for OpenVMS 


4.3.1 Where to Find More Information 


For step-by-step instructions about registering licenses, see the OpenVMS License 
Management Utility Manual and Appendix B of this manual, which provides 
supplemental information. | 


4.4 Backing Up Your System Disk 


Now that you have spent time installing the operating system, you should 
protect your work by making a backup copy of the system disk in case you have | 
any problems while customizing it. Digital recommends that you perform the 
following operations: 


@ Make a standalone BACKUP kit on the system disk and on removable media 
e Perform a standalone BACKUP of your system disk 
You should back up your system disk again after you have customized it. | 
For complete information about these operations, see the upgrade and installation 
supplement for your VAX computer. 7 

4.5 Customizing the System 


You can customize the system to meet the specific needs of your site. In addition, 
if your VAX computer is part of a VAXcluster environment, you must prepare the 
cluster environment and configure the cluster. 


For instructions about customizing your system, refer to the following: 


e Read the chapter on booting in the upgrade and installation supplement for 
your VAX computer. This chapter explains the different ways to boot the 
system. It also tells you how to shut down the system. 


e Ifthe computer is part of a VAXcluster environment, read OpenVMS Cluster 
_ Systems for further information about setting up a cluster. 


e Read the OpenVMS System Manager’s Manual: Essentials for instructions 
on customizing and using your system. You will find information about the 
following tasks: | 


— Editing the template files SYCONFIG.COM, SYLOGICALS.COM, 
SYLOGIN.COM, and SYSTARTUP_VMS.COM 


— Starting the queue manager and creating a queue database. (If you are 
installing on a VAXcluster system with multiple system disks, see the 
OpenVMS Cluster Systems for additional instructions. ) 


— Setting up user accounts 
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— Adjusting system parameters 


e If you plan to use either the DECnet—Plus product included on the OpenVMS 
VAX Version 7.1 kit or the DECnet Phase IV layered product, read Section 4.6 
and perform the steps described there. If you are installing the DECnet— 
Plus software, you should also refer to the DECnet—Plus installation and 
configuration documentation. 


e If you installed DECwindows support software, there are several steps you 
must take to customize your DECwindows environment. Depending on your 
configuration, these tasks might include: 


— Customizing the server startup 


— Using the Transmission Control Protocol/Internet Protocol (TCP/IP) as a 
DECwindows transport 


— Using transports for DECwindows other than those supplied by Digital 


See Chapter 9 for complete instructions for customizing your DECwindows 
support software. 


e If you installed the optional OpenVMS Management Station files, see 
Appendix G for information about preparing your OpenVMS system and your 
PC to use this application. 


4.6 Configuring and Starting Networking Software 


In local area and mixed-interconnect VAXcluster systems, DECnet software 
provides both system management functions and cluster communications, such as 
remote booting operations. DECnet software ensures that system managers can 
access all VAXcluster computers from a single terminal. 


You can use the DECnet—Plus software included on the OpenVMS VAX Version 
7.1 kit, or you can install the DECnet Phase IV layered product. 


Both of these products require that you run a configuration procedure to configure 
the network. If you choose to run the DECnet Phase IV product, you must also 
edit your system startup file as described in Section 4.6.2. 


4.6.1 Configuring Your System 
After you have registered your DECnet license, execute one of the following 
interactive configuration procedures: 


e For the DECnet Phase IV software, run SYS$MANAGER:NETCONFIG.COM. 
(See the DECnet for OpenVMS Guide to Networking for more information.) 


e For the DECnet—Plus for OpenVMS layered product, run 
SYS$MANAGER:NET$CONFIGURE.COM. (See the DECnet-Plus for 
OpenVMS Installation and Basic Configuration for more information. 


4.6.2 Editing SYSTARTUP_VMS 


If you plan to run DECnet—Plus, you do not need to edit this file because DECnet 
will start automatically. 


If you plan to run DECnet Phase IV, after you start the queue manager, edit the 
commands in SYS$COMMON:[SYSMGR]SYSTARTUP_VMS.COM that pertain 
to networking, so that DECnet starts automatically when your system is booted. 
Choose one of the following commands to start the network and remove the 
comment delimiter (!) from that command: 
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$! IF FSSEARCH("SYSSSYSTEM:NETACP.EXE") .NES. "" THEN @SYSSMANAGER:STARTNET 
$! IF FSSEARCH("SYSSSYSTEM:NETACP.EXE") .NES. "" THEN SUBMIT SYS$MANAGER: STARTNET.COM 


Both of the previous commands perform the same task. However, the first 
command executes STARTNET.COM and delays further processing until the 
procedure is completed; the second submits STARTNET.COM to a batch queue 
and continues executing SYSTARTUP_VMS.COM. If you plan to run both 
DECnet Phase IV and DECwindows Motif for OpenVMS VAX, you must also edit 

~SYS$COMMON:[SYSMGR]SYSTARTUP_VMS.COM to add a comment delimiter 
(!) immediately following the dollar-sign ($) in the DEFINE DECW$IGNORE_ 
DECNET command as follows: 


$! DEFINE DECWSIGNORE DECNET TRUE 
If you are not going to start DECnet Phase IV or have not yet started it, this 
command tells DECwindows not to wait for DECnet. 


4.7 Testing the System with UETP Software 


UETP software is a user environment test package that tests whether 
the OpenVMS VAX operating system is installed correctly. As part of the 
postinstallation procedure, you should run UETP to verify your installation. 


Note that UETP needs at least 1200 free blocks on the system disk and is 
available only if you installed the optional save set VMS071.D. If you did not 


install the optional save set, you can add the UETP files to your system using 
VMSTAILOR. | 


For information about using VMSTAILOR see Chapter 10. 


For complete information about UETP, see the OpenVMS System Manager’s 
Manual: Tuning, Monitoring, and Complex Systems. 


4.8 Decompressing System Libraries 


Decompressing the system libraries gives the system faster access to them. You 
can decompress all the system libraries or just some of them. Table 4—1 gives the 
approximate number of blocks consumed by each library after decompression. 


Table 4-1 Sizes of Decompressed System Libraries 


Library - Blocks Library - Blocks 
HELPLIB.HLB 9108 EDFHLP.HLB 102 
STARLET.OLB 8442 TPUHELP.HLB 1038 
VAXCCURSE.OLB 102 . ACLEDT.HLB 102 — 
VAXCRTL.OLB ATT INSTALHLP.HLB 102 
VAXCRTLG.OLB 102 LATCP$HELP.HLB 240 
DECCCURSE.OLB 102 | MNRHELP.HLB 102 
DECCRTL.OLB | 183 PATCHHELP.HLB © 102 
DECCRTLG.OLB 102 PHONEHELP.HLB 102 
ERFLIB.TLB 105 -SDA.HLB 111. 


STARLETSD.TLB 4800 SHWCLHELP.HLB 150 
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Table 4—1 (Cont.) Sizes of Decompressed System Libraries 


Library Blocks Library Blocks 
MAILHELP.HLB 273 SYSGEN.HLB 393 
EDTHELP.HLB 231 TECO.HLB 102 
DBG$UIHELP.HLB 408 UAFHELP.HLB 372 
DBG$HELP.HLB 1986 EVE$HELP.HLB 1197 
EXCHNGHLP.HLB 117 EVE$KEYHELP.HLB 147 
NCPHELP.HLB 537 STARLET.MLB 2502 
ANLRMSHLP.HLB 102 LIB.MLB 2229 
DISKQUOTA.HLB 102 


The additional amount of disk space required to decompress all the system 
libraries is about 13,500 blocks. To find out how much disk space you have, enter 
the following command and press the Return key: 


$ SHOW DEVICE SYSSSYSDEVICE 


To decompress the system libraries, you run LIBDECOMP.COM by logging in to 
the SYSTEM account, entering the following command, and pressing Return: 


$ @SYSSUPDATE:LIBDECOMP.COM 
The following information is displayed: 


OpenVMS Library Decompression Utility 


1 HELPLIB.HLB 14 NCPHELP.HLB 27 PATCHHELP.HLB 

2 STARLET.OLB 15  SDA.HLB 28 PHONEHELP.HLB 

3 ACLEDT.HLB 16 SHWCLHELP.HLB 29 LIB.MLB 

4 ANLRMSHLP.HLB 17 SYSGEN.HLB 30 STARLET.MLB 

5 DBGSHELP.HLB 18 ANALAUDITSHELP.HLB 31 STARLETSD.TLB 

6 DBGSUIHELP.HLB 19 SYSMANHELP.HLB 32 ERFLIB.TLB 

7 DISKQUOTA.HLB 20 TFFSTFUHELP.HLB 33. VAXCCURSE.OLB 

8 EDFHLP.HLB 21 EXCHNGHLP.HLB 34 VAXCRTL.OLB 

9 INSTALHLP.HLB 22 TPUHELP.HLB 35 VAXCRTLG.OLB 
10 LATCPSHELP.HLB 23. EVESHELP.HLB 36 IMAGELIB.OLB 
11 4 MAILHELP.HLB 24 EVESKEYHELP.HLB 37 DECCCURSE.OLB 
12 MNRHELP.HLB 25 UAFHELP.HLB 38 DECCRTL.OLB 
13 EDTHELP.HLB 26 TECO.HLB 39 DECCRTLG.OLB 


A ALL libraries to be decompressed 
E EXIT this procedure 


* Enter letter or number(s) of libraries to be decompressed 
(Separate multiple entries with a comma): 


Enter the appropriate letter or the numbers of the libraries you want to 
decompress. To decompress all libraries, the process takes approximately one half 
hour. | | 


If you prefer, you can execute LIBDECOMP interactively or as a batch job. If 
you use either of these methods, you can decompress up to 8 libraries each 

time you execute LIBDECOMP by listing the names of the libraries you want 

to decompress as parameters on the command line. (You can decompress all 

the libraries by omitting the /PARAMETERS qualifier.) Be sure to separate the 
library names with commas and do not include the file extension. For example, to 
decompress the VAXCRTL.OLB, DISKQUOTA.HLB, and LIB.MLB libraries as a 
batch job, enter the following command: 
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$ SUBMIT/NOTIFY/PARAMETERS=(VAXCRTL, DISKQUOTA, LIB)- 
_$ SYS$UPDATE:LIBDECOMP 


‘To decompress these same libraries interactively, enter the following command: 
$ @SYSSUPDATE: LIBDECOMP VAXCRTL DISKQUOTA LIB 


Note that, when you type the command for a batch job, you separate the library 
names with commas and enclose the list within parentheses. You do not use 
commas or parentheses on the interactive command line. : 


4.9 Removing or Adding OpenVMS Files 


To remove unwanted OpenVMS VAX files from the system disk, use VMSTAILOR 
or DECW$TAILOR. For example, if you are not running DECnet software, use 
VMSTAILOR to remove the files associated with DECnet. 

Note 


You cannot use VMSTAILOR to remove files installed on an alternate 
device from save set VMS071.E. 


For complete information about using VMSTAILOR and DECW$TAILOR to 
remove optional OpenVMS VAX software, see Chapter 10. 


4.10 Installing Layered Products 


Back up your system disk and then use either the VMSINSTAL command 
procedure or the POLYCENTER Software Installation utility to install layered 
products on your system. 


For additional information about installing layered products, see the OpenVMS — 
System Manager’s Manual. 


4.10.1 TCP/IP Services for OpenVMS 


If you installed the Digital TCP/IP Services for OpenVMS software during the 
installation or if you choose to install it now as a layered product, note that you 
must also install the mandatory security update kit included with this release. 


The Digital TCP/IP Kit and the mandatory Security Update Kit are available in 
the following directory on the OpenVMS VAX CD-ROM: 


[TCPIP VAX 041] 


If you choose to install the Digital TCP/IP Services for OpenVMS software, you 
must install both kits. 


4.11 Backing Up the Customized System Disk 


Now that you have spent time installing and customizing the operating system, 

_ protect your work by making a standalone backup copy of the system disk. For 
complete information about these operations, see the upgrade and installation 
supplement for your VAX computer. | 
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4.12 Running AUTOGEN 


When you installed the OpenVMS VAX operating system, the procedure executed 
AUTOGEN to set the values of system parameters and the sizes of the page and 
swap files according to the system’s workload. 


In many cases, AUTOGEN can improve system performance by using dynamic 
feedback information from the running system. As a postinstallation task, you 
should run AUTOGEN again using the feedback mechanism to make further 
adjustments to system parameters. 


4.12.1 How AUTOGEN Works 


When AUTOGEN runs, it uses the parameter values in 
SYS$SYSTEM:MODPARAMS.DAT. Note that hardcoded values in 
MODPARAMS.DAT affect AUTOGEN’s calculations of the feedback parameters. 
For AUTOGEN to properly calculate minimum default values, you should replace 
the hardcoded values in MODPARAMS.DAT with MIN_ values. If you need to 
modify the parameter values calculated by AUTOGEN, you can use AUTOGEN 
to change the hardcoded values in MODPARAMS.DAT. 


For information about using AUTOGEN, see the OpenVMS System Manager’s 
Manual: Essentials. 


4.12.2 When to Run AUTOGEN 
After installing the operating system, run AUTOGEN again using the following 


procedure: 
1. After 24 hours of operation, run AUTOGEN in feedback mode and reboot the 
system. 


2. Run AUTOGEN in this same way, again, two working days later. 


Note: For large memory systems such as the VAX 9000 computer, 
AUTOGEN’s initial parameter calculations are conservative. To obtain 
parameter values that match your system workload, you can run AUTOGEN 
in feedback mode a number of times. For more information, see the upgrade 
and installation supplement for your computer. 


3. Digital recommends that you run AUTOGEN from SAVPARAMS through 
TESTFILES on a weekly basis and examine AGEN$PARAMS.REPORT to 
determine the need for additional changes. 


After you run AUTOGEN following the first 24 hours of system operation (step 
1), review the checklist in Section 4.13 to confirm that you have es all the 
tasks described in this chapter. 


4.13 Postinstallation Checklist 


Use the following checklist to make sure you perform all the necessary 
postinstallation tasks. 


|_| Verify the system time. (Described in Section 4.2.) 


[_] Register your licenses if you did not do so during the installation procedure. 
(Described in Appendix B of this manual and in the OpenVMS License 
Management Utility Manual.) 


| | Build a standalone BACKUP kit on the system disk and on removable media. 
(Described in the upgrade and installation supplement for your computer.) 
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| ] Back up the system disk as a safeguard before customizing the system. 
(Described in the upgrade and installation supplement for your computer.) 


[_] Customize the system. (Described in Section 4.5.) 
[| Configure and start your networking software. (Described in Section 4.6.) — 
a 


Run UETP (the User Environment Test Package) to test the system. 
(Described in OpenVMS System Manager's Manual: Tuning, Monitoring, and 


Complex Systems.) 


Decompress the system libraries using LIBDECOMP.COM. (Described in 
Section 4.8.) 


Remove unwanted files from the system disk using the penne pinged 
utility. (Described in Chapter 10.) 


Install layered products. 


Back up the system disk after you have customized it. (Described in the 
upgrade and installation supplement for your computer.) 


Run AUTOGEN after the system has been running for at least 24 hours to 
collect feedback information. (Described in Section 4.12.) 


ie ee ee ee 
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Before Upgrading OpenVMS VAX Software 


5.1 Overview 


Before you begin an upgrade, you need to perform several important tasks to 
prepare the system. This chapter describes what you need to know and do to 
prepare for an upgrade, including: 


e Being aware of the cautions and restrictions 


e Making sure your hardware is ready and your software distribution kit is 
complete 


e¢ Examining AUTOGEN feedback data 

e Backing up your system disk 

e Preparing your system disk 

e Preparing your system 

e Gathering the information for the upgrade procedure 
¢ Completing the preupgrade checklist 


If you are an experienced system manager, you can use the checklist at the end of 
this chapter to complete the necessary preupgrade tasks. 


If you are system manager with limited OpenVMS VAX experience, you should 
read the entire chapter and then use the checklist to make sure you have 
~ completed all the preupgrade tasks. 


5.2 Cautions and Restrictions 


This section provides important information that you need to be aware of before 
you upgrade your system. If you attempt to upgrade your system without 
following these cautions and restrictions, the upgrade could fail or your upgraded 
system might not perform as expected. 


5.2.1 License Requirements 


To upgrade to OpenVMS Version 7.1, you must have an appropriate license. 
Digital’s software licenses grant the right to use the current version of a product 
or any previous version of the product at the time of purchase. If you have an 
OpenVMS license prior to Version 7.1 and are not covered by a Software Product 
Services agreement, which includes the right to use new versions (RTNV), you 
must purchase an Update License before upgrading to OpenVMS Version 7.1. 


If you do not have an Update License, please contact your Digital account 
representative who will assist you in obtaining the correct Product Authorization 
Key (PAK) needed to access the OpenVMS operating system. 
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5.2. 2 DECset Version 11 Debugger 


If you have the DECset Version 11 layered product installed on your system, you 
must remove the @DEBUG$STARTUP.COM command from the system startup 
procedure. The debugger shipped with OpenVMS VAX Version 7.1 is a superset of 
the debugger that was shipped with the DECset Version 11 software. Removing . 
the @DEBUG$STARTUP.COM command will cause the debugger shipped with 
OpenVMS VAX Version 7.1 to be the default system debugger. 


To remove the @DEBUG$STARTUP.COM command before you upgrade the 
operating system software, perform the following steps: 


1. Log in to an account with system privileges. 


2. Using the editor of your choice, open the SYS$STARTUP:SYSTARTUP_ 
VMS.COM file and search for the following command: 


$ @DEBUGSSTARTUP 


Delete the command and any parameters. (The command might have an 
optional parameter of either VMS or DECSET.) 


3. Exit from the file, saving the change. 


If you do not remove this command before you upgrade the operating system 
software, you must remove it after the upgrade, and you must deassign the 
logicals that were defined by DEBUG$STARTUP. COM by performing the 
following steps: 


1. Log in to the account that you used to perform the upgrade. 
2. Enter the following commands: 


$ DEASSIGN/SYSTEM DEBUG 

S$ DEASSIGN/SYSTEM DEBUGSHR 

$ DEASSIGN/SYSTEM DEBUGUISHR 

$ DEASSIGN/SYSTEM DBGTBKMSG 

$ DEASSIGN/SYSTEM DBGS$HELP 

$ DEASSIGN/SYSTEM DBGSUIHELP 

$ DEASSIGN/SYSTEM DEBUGAPPCLASS 
$ DEASSIGN/SYSTEM VMSDEBUGUIL 


3. Using the editor of your choice, open the SYSTARTUP_VMS.COM file and 
search for the following command: 


$ @DEBUGSSTARTUP 


Delete the command and any parameters. (The command might have an 
optional parameter of either VMS or DECSET.) 


4, Exit from the file, saving the change. 


5.2.3 Customized Security Environment 


The Version 7.1 upgrade procedure provides new files and directories in the 
directory [VMS$COMMON...]. If you had any special protections and access 
control lists (ACLs) before the upgrade, you need to reapply them to reestablish 
the security environment you had previously established. For more information 
on creating and maintaining a secure environment, see the OpenVMS Guide to 
System Security. 
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5.2.4 Operator and Accounting Logs 


The upgrade procedure deletes all the operator and accounting logs. To save 
these files, move them to a user directory before you start the upgrade. 


5.2.5 Special Testing and Debugging Files 


Before you perform an upgrade, remove or rename any special testing 

or debugging files that you might have in any of the SYS$SPECIFIC: or 
SYS$SYSROOT: directories. Files in these directories are used in place of 
the files in SYS$}COMMON: directories. 


As a minimum, you should check the following directories: 


SYSSSYSROOT: [ SYSEXE ] 
SYSSSYSROOT: [ SYSSLDR] 


Because the upgrade procedure affects the SYS$COMMON: directories and 

does not check or alter the contents of the SYS$SPECIFIC: or SYS$SYSROOT: 
directories, any testing or debugging files that you have in these directories 
remain there unchanged until you remove or rename them. If you do not remove 
or rename these files, your system might behave in an unpredictable manner. 


5.2.6 Cluster Considerations 


The following cautions apply when you are upgrading a cluster system: 


e The upgrade procedure does not work across the network. The network is not 
available during the upgrade, so you must have the save sets available locally 
or on the InfoServer. 


e Ifthe node you are upgrading is a cluster member, the upgrade procedure 
checks the previously set values of several system parameters at the 
beginning of the upgrade (see Section 7.3.) If any of the values are less 
than that required to upgrade to OpenVMS VAX Version 7.1, you are given 
the choice of continuing or canceling the upgrade. If you choose to continue 
the upgrade, the entire upgrade might not be completed and the cluster might 
be left in a hung state. 


e Before you start the upgrade procedure in a VAXcluster environment, you 
must shut down all the nodes that boot from the system disk you are 
upgrading, including the node you perform the upgrade on. 


5.2.7 Save Set Location 


If you move the OpenVMS VAX save sets from the distribution media to the 
system disk or some other disk before beginning the upgrade, the save sets must 
be in the [000000] directory of the disk, or the upgrade will fail. 


Do not attempt to use VMSINSTAL with OPTION G to transfer OpenVMS VAX 
save sets to another media type; doing so will produce an unusable system. 
Instead, you can use the DCL command COPY to transfer save sets to another 
media type. 
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5.2.8 System Disk Cautions 
The following cautions apply to the system disk: 


If you changed the names of system directories on your system disk, the 
upgrade procedure will not work correctly. Restore your system disk to a. 
standard directory structure before you attempt an upgrade. 


You must not move the system disk or the distribution kit from one drive to 


another during the upgrade. 


You cannot upgrade a shadowed system disk. If your system disk is part of a 
shadow set, you must create a nonshadowed system disk before beginning the 
upgrade. 


Also, if you copy the distribution media to another disk, that disk must be a 
nonshadowed disk. 


For more information, see the manual Volume Shadowing for OpenVMS. 


If you elect not to install optional components, the upgrade procedure 


- removes existing files for those components from the system disk. You can 


install optional files during the upgrade or later using VMSTAILOR. 


Note that, while some optional files can be placed on an alternate device, you 
cannot tailor files on or off an alternate device. 


5.2.9 AUTOGEN Feedback Data 


If you use your AUTOGEN feedback data, you should save this information 
before rebooting the system with minimum startup to begin the upgrade. For 
more information, see Section 5.4. | 


5.2.10 OpenVMS Version Requirements 


Before you can upgrade to OpenVMS VAX Version 7.1, your system must be 
running at least Version 6.1 of the OpenVMS operating system. For example, you 

-can upgrade a system disk to Version 7.1 of the OpenVMS VAX operating system 
from any of the following versions (or related hardware releases): 


OpenVMS VAX Version 6.1 
OpenVMS VAX Version 6.2 
OpenVMS VAX Version 7.0 


5.2.11 DECwindows Motif Version Requirements 


If you want to use DECwindows software with OpenVMS VAX Version 7.1, you 
must be running Version 1.2—3 or higher of the DECwindows Motif for OpenVMS 
layered product. 


For more information, see Section 1.2.1. 


5.2.12 Shared System Dump Files __ 
If you have a shared system dump file in SYS$COMMON:[SYSEXE], the 
shared dump file cannot have the name SYSDUMP.DMP. If you have a shared 


system dump file with this name, Digital recommends that you rename it to 
SYS$COMMON:|[SYSEXE]SYSDUMP_COMMON.DMP. 
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5.2.13 Layered Products 


The upgrade procedure is designed so that you should not have to reinstall most 
layered products after the upgrade. However, you might need to reinstall certain 
layered products because of product-specific installation procedures. 


If a layered product is available yet exhibits unexpected behavior once Version 7.1 
of the OpenVMS VAX operating system is running, check the OpenVMS Version 
7.1 Release Notes for possible layered-product restrictions. 


5.3 Are You Ready to Upgrade? 


Before you begin to upgrade the OpenVMS VAX operating system, be sure you 
have all the required hardware and software components. 


5.3.1 Hardware Components 


Examine your hardware for the following: 


e Make sure your hardware has been checked for proper operation. To perform 
a successful upgrade, you must understand the basic operations of the VAX 
computer that you are upgrading. Refer to the upgrade and installation 
supplement for your VAX computer. If you have a VAXcluster environment, 
refer to OpenVMS Cluster Systems. 


e Set up your system to record the upgrade procedure on either a hardcopy 
terminal or a printer attached to the console terminal. If you do not do this, 
the screen messages will be lost. You will need a transcript in case there is 
a problem during the upgrade. For more information, see the upgrade and 
installation supplement for your VAX computer. 


e Have scratch console media (media that does not contain files you want to 
save) available for the following VAX computers: 


VAX 8600, 8650 

VAX 8200, 8250, 8300, 8350 
VAX-—11/730 

VAX—11/750 

VAX—11/780, 785 


For example, if you have a VAX—11/780 or VAX—11/785 computer, you need a 
scratch RX01 floppy diskette. 
5.3.2 Software Components 


Examine your software for the following: 


e Make sure you have all the items listed on the bill of materials (BOM) in the 
OpenVMS distribution kit. If your kit is incomplete, notify Digital Software 
Supply, and request priority shipment of any missing items. | 


e Before upgrading the OpenVMS VAX operating system, read Appendix B of 
this manual, the OpenVMS Version 7.1 New Features Manual, the OpenVMS 
Version 7.1 Release Notes, and any cover letters included with your kit. 


5.4 Examining AUTOGEN Feedback Data 


After the upgrade is finished, AUTOGEN runs. If it finds valid feedback data on 
your system, it tries to use AUTOGEN feedback. 
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5.4.1 Valid Feedback Data 


Feedback data is produced by the SAVPARAMS phase of AUTOGEN and is stored 
in SYS$SYSTEM: AGEN$FEEDBACK.DAT. Valid feedback data 1 is defined as 
follows: 


e The system was up for at inact 24 hours when the feedback data was 
gathered. 


e The feedback data is not over 30 days old. 


If your feedback data is not valid, AUTOGEN will run without feedback (all 
previous feedback-generated parameters will be replaced by the AUTOGEN 
NOFEEDBACK calculations). 


5.4.2 How to Test Feedback Data | 
To ensure that AUTOGEN feedback will run after the upgrade, do the following: 


1. Check the validity of your current feedback data by entering the following 
command: 


S$ @SYSSUPDATE:AUTOGEN GETDATA TESTFILES 


This command is for test purposes and does not result in the modification 
of system parameters or changes to the page and swap files. If your current 
feedback is valid, AUTOGEN will use it during the ee and you can 
proceed to the next section. 


If your current feedback data is invalid, AUTOGEN will issue several 
warnings. If you get these warnings, go to step 2. 


2. If your current feedback is invalid, you can generate new feedback data 
(assuming your system was up for at least 24 hours). Enter the following 
command: 


$ @SYSSUPDATE:AUTOGEN SAVPARAMS TESTFILES 


This command is for test purposes and does not result in the modification of 
system parameters or changes to the page and swap files. Again, AUTOGEN 
warns you if the feedback data just produced is invalid. 


3. If you follow steps 1 or 2 and your current feedback data is valid, AUTOGEN 
uses your current feedback-generated parameters during the upgrade. Your 
current feedback-generated parameters will not be lost during the upgrade. | 


5.5 Performing Backup Tasks 


Digital recommends that you make a standalone backup copy of the system 
disk and, if your configuration allows it, upgrade the backup copy. If there are 
problems, you will still have a working system disk. 


5.5.1 How to Back Up the System Disk 


To make a backup copy of the system disk, follow the instructions in the upgrade 
and installation supplement for your VAX computer. If you do not have a 
removable system disk, back up your system disk to tape and restore the image 
backup to the system disk. This eliminates disk fragmentation on the system disk 
and creates contiguous free disk blocks required for the upgrade. (The upgrade 
can fail if there are not sufficient contiguous free blocks.) Store the backup tapes 
in a safe place. 
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5.5.2 How to Back Up Console Media 


If you have one of the following VAX computers, you also must make a backup 
copy of the console media: 


VAX—11/730 

VAX-—11/750 

VAX-—11/780, 785 

VAX 8200, 8250, 8300, 8350, 8600, 8650 


To make a backup copy of the console media, use the 
SYS$UPDATE:CONSCOPY.COM procedure, as described in the upgrade and 
installation supplement for your VAX computer. Use the backup copy of the 
console media during the upgrade procedure. The upgrade procedure updates the 
console media for you. | , 


If your VAX computer uses one of the following console media, you did not receive 
a new standalone BACKUP kit with your OpenVMS VAX distribution kit: 


TU58 tape cartridge 
RX33 diskette 
RX50 diskette 
RX01 diskette 
RLO2 disk cartridge 


Before beginning the upgrade, make sure you have a standalone BACKUP kit 
on one of these media. If you do not have one, create a standalone BACKUP 
kit using the STABACKIT.COM procedure as described in the upgrade and 
installation supplement for your VAX computer. 


Note 


You cannot build standalone BACKUP on TU58 or RXO1 console media 
because the OpenVMS VAX Version 7.1 kit is too large. If your VAX 
computer uses a TU58 or RX01, build a standalone BACKUP kit before 
upgrading and retain the backup copies for use with future versions of 
OpenVMS VAX. 


5.6 Preparing Your System Disk 


To prepare the system disk for the upgrade, log in to the SYSTEM account and, 
depending on your configuration, complete some or all of the tasks described in 
the sections that follow. | 


5.6.1 Create a Nonshadowed System Disk 


If you are using a volume-shadowed system disk, you must create a nonshadowed 
system disk to upgrade. Follow the instructions in the Volume Shadowing for 
OpenVMS manual to prepare a nonshadowed system disk for the upgrade. 

5.6.2 Boot the Backup Copy of Your System Disk 


If you need to boot the backup copy of your system disk or if you are upgrading a 
VAXcluster environment, enter the following command (otherwise, go to the next 
step): , 


S @SYSSSYSTEM: SHUTDOWN 
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When the procedure asks if an automatic system reboot should be performed, 
press Return for NO. If you are a VAXcluster member, choose the CLUSTER_ 
SHUTDOWN option. When the procedure is finished, halt the system as 
described in the upgrade and installation supplement for your VAX computer. 


If applicable, remove the system disk and replace it with the backup copy. 
Boot the system from the backup copy of the system disk. If you do not know how 
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computer. 


Log in to the SYSTEM account. 


5.6.3 Copy UAF and Auditing Files to the System Disk 


The current copies of the SYSUAFDAT and the VMS$AUDIT_SERVER.DAT files 
must be on the system disk; otherwise, you cannot proceed with the upgrade. 


If you have moved your copy of SYSUAF.DAT to another location, copy it to the 
SYS$COMMON:[SYSEXE] directory for the duration of the upgrade. 


If you have moved your copy of VMS$AUDIT_SERVER.DAT to another location, 
copy it to the SYS$COMMON: |[SYSMGR] directory. 


Note that, if you are doing a rolling upgrade, the shared version of SYSUAF. DAT 
is not updated. 


Move any files that you do not want changed into a user directory. 


5.6.4 Rename the System Dump File 


If you have a shared system dump file in SYS$COMMON:[SYSEXE], the 
shared dump file cannot have the name SYSDUMP.DMP. If you have a shared 
system dump file with this name, Digital recommends that you rename it to 
SYS$COMMON: [SYSEXE]SYSDUMP-COMMON.DMP. 


9.6.5 Analyze the System Disk 


To analyze the system disk for inconsistencies and errors in the file structure, 
enter the following command: 


$ ANALYZE/DISK STRUCTURE SYSSSYSDEVICE 
The following message represents normal behavior; you can ignore it: 
tANALDISK-I-OPENQUOTA, error opening QUOTA.SYS 


If you find any other errors on the system disk, repair the errors by entering the 
following command: . 


S ANALYZE/DISK _ STRUCTURE/REPAIR SYSSSYSDEVICE 


Refer to the OpenVMS System Management Utilities Reference Manual for more 
information on the ANALYZE/DISK STRUCTURE command. 


5.6.6 Check Page and Swap Files 


Digital recommends that the page file be located on the system disk in 
SYS$SPECIFIC:[SYSEXE] for the upgrade. 


The swapfile (SWAPFILE.SYS) does not need to be located on the system disk for 
the upgrade, but if it is located on the system disk, the file must be located in 
SYS$SPECIFIC:[SYSEXE]. 
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If the upgrade procedure finds the page files and swap files in the common 
directory, it will move them to the system-specific directory before continuing. 


The page file must be at least 4600 blocks. If the upgrade procedure detects fewer 
than 4600 blocks, it displays a message that gives you the option of continuing 
the upgrade or exiting the procedure and increasing the size of the page file. If 
you get this message, Digital recommends that you exit the procedure, increase 
the page file to at least 4600 blocks, and restart the upgrade procedure. 


To check the size of your page file and enter a new size if needed, use the 
following procedure: 


1. To determine the size of the page file, enter the following command: 
S$ @SYSSUPDATE:SWAPFILES 


The procedure displays the size of the page file and asks you to enter a new 
value, as follows: 


Enter new size for paging file: 


If the page file (PAGEFILE.SYS) size is greater than 4600 blocks, press the 
Return key. If it is less than 4600 blocks, enter 4600 and press Return. 


2. Ifthe swap and dump files are on the system disk, the procedure displays the 
sizes of each file. To keep the current values, press Return after each prompt. 


If the swap file is not on the system disk, the procedure asks if you want to 
create one. You do not need swap and dump files on the system disk for the 
upgrade procedure. Enter the appropriate response for your system. 


If you changed the size of the page file or created a swap file, a message is 
displayed that tells you to reboot the system. Do not reboot now. You will 
reboot later. 


5.6.7 Check for Free Blocks 


Check the system disk to make sure there is enough room for the upgrade. To 
determine whether you have enough room, enter the following command: 


S$ SHOW DEVICE SYSSSYSDEVICE 


To upgrade the OpenVMS VAX required files, the minimum number of free blocks 
required is 48,950. Even if you plan to upgrade the OpenVMS library or optional 
files, you might not need more than 48,950 free blocks because many files are 
deleted as the upgrade progresses, thus freeing up additional space. 


5.6.8 Check Quotas and Limits 


Use the Authorize utility (AUTHORIZE) to make sure the SYSTEM account has 
sufficient quotas and limits. To check and, if necessary, modify quota and limit 
values, do the following: 


1. Enter the following commands: 


$ SET DEFAULT SYSSSYSTEM 
$ RUN AUTHORIZE 
UAF> SHOW SYSTEM 


AUTHORIZE displays the SYSTEM account’s quota and limit values. 
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2. Compare the values displayed on ‘your screen to the following minimum 
required values: 


Quota or Limit Name — Minimum Value 
Open file quota (FILLM) 300 

Buffered I/O limit (BIOLM) | 18 

Direct I/O limit (DIOLM) 18 

AST limit (ASTLM) 24 

Enqueue quota (ENQLM) 200 

Buffered byte quota count (BYTLM) | 327687 


TIf you are using an InfoServer novice to upgrade your system, increase the value of BYTLM to © 
33150 | 


3. If necessary, adjust the quota and limit values in your SYSTEM account so 
that they are equal to or greater than the minimum required values. 


To change the value for a quota or limit, enter the MODIFY SYSTEM 
command using the following format: 


MODIFY SYSTEM/imit=new_value 
| For example: 
UAF> MODIFY SYSTEM/DIOLM=18 
4. Exit the Authorize utility by entering the following command: 
UAF> EXIT 


5. If you adjusted the values for any of the SYSTEM account quotas or limits, 
log out and log back in to have the new values take effect. 


5.6.9 Set System Parameters 


During the upgrade procedure, the system is shut down and rebooted a number 
of times. You must boot the system minimum (STARTUP_P1 set to MIN) before 
you begin the upgrade (see Section 5.7). This prevents startup of certain system 
integrated products and layered products on the system during each reboot. To 

set the system parameter STARTUP_P1 to MIN, enter the following commands: 


S RUN SYSSSYSTEM: SYSMAN 

SYSMAN> PARAMETERS USE CURRENT 

SYSMAN> PARAMETERS SET STARTUP Pl "MIN" 
SYSMAN> PARAMETERS WRITE CURRENT | 
SYSMAN> EXIT | 


Make sure the system parameters SCSNODE and SCSSYSTEMID are defined on 
your system. To determine whether these parameters are defined on your system, 
enter the following commands: 


S$ RUN SYSSSYSTEM: SYSMAN 
SYSMAN> PARAMETERS SHOW SCSNODE 
SYSMAN> PARAMETERS SHOW SCSSYSTEMID 


If SCSNODE and SCSSYSTEMID are not set correctly, enter the following 
commands where node is a 1- to 6-character unique DECnet node name and 
systemid is (DECnet area * 1024) + node number: 
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SYSMAN> PARAMETERS USE CURRENT 

SYSMAN> PARAMETERS SET SCSNODE "node" 
SYSMAN> PARAMETERS SET SCSSYSTEMID systemid 
SYSMAN> PARAMETERS WRITE CURRENT 


Make sure the system parameter VMS5 is set to 0. If your system has a KFQSA 
controller, the VMS5 parameter might have been set to a nonzero value for a 
previous upgrade. The VMS5 parameter is reserved for Digital’s use only. 


To check the value of the VMS5 parameter, enter the following commands: 


S RUN SYSSSYSTEM: SYSMAN 

SYSMAN> PARAMETERS USE CURRENT 

SYSMAN> PARAMETERS SHOW VMS5 

Parameter Name Current Default Minimum Maximum Unit Dynamic 


If the current value of VMS5 is not 0, set it to 0 by entering the following 
commands: 


SYSMAN> PARAMETERS USE CURRENT 
SYSMAN> PARAMETERS SET VMS5 0 
SYSMAN> PARAMETERS WRITE CURRENT 
SYSMAN> EXIT 


If you used the Snapshot facility to boot your current system with a system 
snapshot image, you must change the BOOT_STYLE system parameter to 
0 before you can perform an upgrade. To change the BOOT_STYLE system 
parameter to 0, enter the following commands: 


S$ RUN SYSSSYSTEM:SYSMAN 

SYSMAN> PARAMETERS USE CURRENT 
SYSMAN> PARAMETERS SET BOOT STYLE 0 
SYSMAN> PARAMETERS WRITE CURRENT 
SYSMAN> EXIT 

: 


You can reexecute the Snapshot command procedure 
(SYS$SMANAGER:SNAPSHOT.COM) after the upgrade is completed, as described 
in the OpenVMS System Manager’s Manual: Essentials. 


5.6.10 Check AGENSINCLUDE Files 


During an upgrade, user disks are not mounted and SYLOGICALS.COM is not 
invoked, so AUTOGEN can access only data files that are on the system disk 
and whose file specification includes a logical name that is shipped as part of 
the OpenVMS operating system. Therefore, if you use AGEN$INCLUDE in 
SYS$SYSTEM:MODPARAMS.DAT to point to data files that are not on a 
system disk, follow these steps before you perform an upgrade: 


1. Copy any files that you want AUTOGEN to include to a directory on the 
system disk. 


2. For each file that you move, change the file specification on the 
AGEN$INCLUDE line in SYS$SYSTEM:MODPARAMS.DAT to point to. 
the new location of the file on the system disk. 


If you do not move referenced data files to the system disk, AUTOGEN uses 
whatever information is available during the upgrade and parameters might be 
set to values considerably different from what you intend. 
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5.6.11 Add Modified iat Parameters to MODPARAMS.DAT 


Any system parameter values that you modified and did not enter in 
MODPARAMS.DAT are lost during the upgrade. To retain the values of 
these parameters, enter their names in MODPARAMS.DAT and the value 
that AUTOGEN needs to add to the default minimum value. 


For example, if you modified GBLPAGES by 128 pages above the default, add the 
_ following line to SYS$SYSTEM: MODPARAMS.DAT: 


ADD _GBLPAGES=128 


When AUTOGEN runs after the upgrade, it uses the values in 
MODPARAMS.DAT. 


Section 5.7 tells you how to get your system ready for an upgrade. 


5.7 Preparing the System 
To prepare the system for the upgrade, use the procedure described in the 
following rdsections. 

5.7.1 Enable Auto Restart or Manual Reboot 


If your computer uses console media, set the computer to restart automatically. 
For some VAX computers this means setting one or more switches. For others, 
this means entering certain console mode commands. To determine how to enable 
auto restart, refer to the upgrade and installation supplement for your VAX 
computer. | 


If you have a system that does not use console media, set your system so you can 
reboot it manually. For more information, refer to the upgrade and installation | 
supplement for your VAX computer. 


5.7.2 Shut Down and Reboot the System 


Shut down and reboot the system to activate any system parameters that you 
changed (STARTUP_P1, for example). To shut down the system, enter the 
following command: 


S$ @SYSSSYSTEM: SHUTDOWN 


~When the procedure asks if an automatic system reboot should be performed, 
type Y (for YES) and press the Return key. 


After the system reboots, log in to the SYSTEM account. 


5.7.3 Prevent Interactive Logins 


To prevent users from logging in to ne system during the upgrade, enter the 
following command: , 


$ SET LOGINS/INTERACTIVE=0 — 
5.7.4 Check for DECnet 


To determine whether your system is running DECnet for OpenVMS software, 
enter the following command: 


$ SHOW LOGICAL SYSSNODE 
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If the system displays the following message, DECnet is not running on your 
system and you can proceed to Section 5.7.6: 


$SHOW-S-NOTRAN, no translation for logical name SYSSNODE 


If the system responds with a translation for SYS$NODE, then DECnet is 
running on your system. 


If you set STARTUP_P1 to MIN as described in Section 5.6.9, DECnet should 
not be running. To set STARTUP_P1 to MIN, repeat all of the preceding steps 
beginning with Section 5.6.9. Note that you must shut down and reboot the 
system for any changes you make to system parameters to take effect. 


5.7.5 Check for Volume Shadowing 


Phase I (controller-based) shadowing is no longer available. Phase II (host-based) 
shadowing is designed to fully replace phase I shadowing with significantly 
enhanced features. 


If you have volume shadowing installed on your system but are unsure which 
phase, you can enter the following commands: 


S$ RUN SYSSSYSTEM: SYSMAN 
SYSMAN> PARAMETERS USE CURRENT 
SYSMAN> PARAMETERS SHOW SHADOWING 


If the SHADOWING parameter is 1 or 3, then you have phase I shadowing 
currently loaded on your system. For ia foEation about migrating to phase II, 
see Volume Shadowing for OpenVMS. 


At the beginning of an upgrade, the procedure checks the setting of the 
SHADOWING system parameter. If you have not migrated to phase II and 

the procedure detects the presence of phase I shadowing, it displays the following 
message and asks if you want to continue the upgrade: 


The SHADOWING system parameter (currently set to 1) specifies 

phase I of volume shadowing, which is no longer available as of 
OpenVMS VAX Version 6.1. If you continue with this upgrade, volume 
shadowing will not be present on your system after the upgrade has 
completed. Please consult the Volume Shadowing for OpenVMS manual 
for instructions about moving to phase II of volume shadowing. 


* Do you want to continue the upgrade? 


At that point, you can exit the upgrade procedure, follow the instructions in 
Volume Shadowing for OpenVMS for migrating to phase II shadowing, and 
restart the upgrade procedure from the beginning. If you continue with the 
upgrade without migrating to phase II, volume shadowing will not be present on 
your system after the upgrade has completed. 

5.7.6 Stop Queues 


To stop all batch and print queues on the node you are upgrading, enter the 
following command: 


$ STOP/QUEUES/ON NODE 


It is not necessary to stop queues on nodes that you are not upgrading. 
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5.8 Gathering Information for the Upgrade 


At different points during the upgrade, the procedure prompts you to supply 
information. To save time once the procedure begins, be sure you have the 
following information readily available. Remember, entering incorrect information 
during the upgrade could force you to repeat the entire upgrade procedure. 


Required Information 


Device names 
Passwords 


Optional components and 
OpenVMS Management. 
Station files 


Location for Help Message 
utility 


DECwindows components 


Explanation 


-You will need to specify the device names for the drives that will hold the 


distribution media and the system disk. 


You will be prompted to type passwords of at least 8 characters for the 
SYSTEM, SYSTEST, and FIELD accounts. 


The upgrade procedure prompts you to specify whether you want to install 
the library (VMS071.C), optional (VMS071.D) OpenVMS components, and 
OpenVMS Management Station software PC files (VMS071.F). Appendix D 
lists the files included in these save sets. 


You can save some space on your system disk if you choose not to install 
these components, but be sure to review Appendix D before deciding. 


Save set VMS071.E contains the online Help Message utility, which you can 
install on your system disk or on an alternate disk. (However, if you copied 
the distribution kit to some other media from which you will be performing 
the installation, you cannot install this save set on that media.) 


The installation procedure prompts you to specify which of the following 
DECwindows components you want to install: 


e DECwindows base support (required for running DECwindows software), 
which includes: 


— DECwindows transport 
— DECwindows keymaps 


e DECwindows workstation support (required for VAX workstations), 
which includes: 


— DECwindows X11 display server 
— Graphics drivers 
— 75 dots/inch video fonts 


— 100 dots/inch video fonts (option available only if you select 
DECwindows workstation support) 


Note that you must install the DECwindows Motif for OpenVMS (previously 
called VMS DECwindows Motif) layered product if you want to run the 
DECwindows software. DECwindows Motif for OpenVMS Version 1.2—3 

(or 1.2 if the VAXMOTF05_012 remedial kit is installed) is the minimum 
supported version for systems running OpenVMS VAX Version 7.1. If you do 
not know which version of DECwindows Motif you are currently running on 
your system, you can check by entering the following command: | 


$ ANALYZE/IMAGE SYSSLIBRARY : DECWSXLIBSHR.EXE 


Also note that the layered product does not have the DECwindows base 
and workstation support components. To get full DECwindows support, you 
must select the DECwindows components provided with the OpenVMS VAX 
Version 7.1 kit and install the separate DECwindows Motif for OpenVMS 
VAX layered product, which supports both Motif and XUI environments. 
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Required Information Explanation 


PAK information 


The information listed on Product Authorization Keys (PAKs) for any new 
products you will register. You do not need to register your OpenVMS VAX 
license or the licenses for any System Integrated Products (SIPs) you are 
already running. 


5.9 Preupgrade Checklist 


Before you begin the upgrade procedure, use the following checklist to make sure 
you have completed all the necessary preupgrade tasks. 


{_] 
| 
[_] 


ip al 


Read the OpenVMS Version 7.1 New Features Manual, the OpenVMS Version 
7.1 Release Notes, and any cover letters that came with your kit. 


Read the cautions and restrictions described at the beginning of this chapter 
and in Chapter 1. 


Make sure you have enough free blocks for the upgrade. You need at least 
48,950 free blocks for the required files to start the upgrade. (Described in 
Section 5.6.) The entire upgrade requires about 163,000 blocks. 


Set up your system to record the upgrade procedure on either a hardcopy 
terminal or a printer attached to the console terminal. If you do not do 
this, the screen messages will be lost. You will need a transcript in case 
there is a problem during the upgrade. For information on how to connect a 
hardcopy device to your console to record the procedure, see the upgrade and 
installation supplement for your VAX computer. 


Check your AUTOGEN feedback information to be sure it is valid before 
rebooting the system. (Described in Section 5.4.) 


Make a backup copy of the system disk and, if applicable, of the console 
media. (Described in the upgrade and installation supplement for your 
computer.) 


If, in previous versions, your distribution kit provided standalone BACKUP 
on one of the following media types, make sure you have created a standalone 
BACKUP kit on one of the following media types: 


RX33 
TU58 
RX50 
RX01 
RLO2 


(Described in Section 5.5.) 


Make sure SYSUAFDAT is in the SYS$COMMON:|[SYSEXE] and 
VMS$AUDIT SERVER.DAT is in the SYS$COMMON: Se directory. 
(Described in Section 5.6.) 


Make sure SWAPFILE.SYS (if it is located on the system disk) and 
PAGEFILE.SYS are in the SYS$SPECIFIC:[SYSEXE] directory. (Described in 
Section 5.6.) 


Make sure the page file is at least 4600 blocks. (Described in Section 5.6.) 


If you have a shared system dump file in SYS$COMMON:|[SYSEXE], make 
sure the shared file is not named SYSDUMP.DMP. (Described in Section 5.6.) 
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If your system disks is part of a shadow set, create a nonshadowed system disk 
to upgrade. (Described in Volume Shadowing for OpenVMS.) 


Make sure the SYSTEM account has sufficient sa and limits. (Described 
in Section 5.6.) 


Set the appropriate system parameters and make sure that STARTUP_P1 is | 
set to MIN. (Described in Section 5.6.) 


Define the system parameters SCSNODE and SCSSYSTEMID. (Described in 
Section 5.6.) 


If your system has a KFQSA controller, make sure the VMS5 parameter is set 
to 0. (Described 1 in Section 5.6.) 


Check the iecation of your AGEN$INCLUDE files. (Described i in 
Section 5.6.10.) 


Set up the system to restart automatically. (Described in the upgrade and 
installation supplement for your VAX computer. ) 


Shut down and reboot the system from which you will perform the upgrade. 
If you are upgrading a VAXcluster, shut down all computers that boot from 
the system disk you are upgrading. 


Set interactive logins to 0. 
Shut down DECnet for OpenVMS software. (Described in Section 5.7.) 


Migrate to phase IT volume shadowing if you are currently using phase I. 
(Described in Section 5.7.) 


Stop all batch and print queues on the node you are upgrading. (Described in 
Section 5.7.) 


Make sure you have the following information (described in Section 5.8) 
available: 7 


e The device names of the drives that will hold the system disk and the 
~ distribution media. 


e Passwords of at least 8 characters for the SYSTEM, SYSTEST, and 
FIELD accounts. 


' @ A-list of optional OpenVMS VAX components you want to install. 


[ 


e A list of optional DECwindows components you want to install. 


e The information listed on Product Authorization Keys (PAKs) for any new 
product licenses you will register. 


Create a command procedure to be used when booting from [SYSF]. See 


Appendix C. 


To upgrade a standalone system, go to Chapter 7. 


To upgrade a VAXcluster environment, go to Chapter 6. 
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Upgrading a VAXcluster Environment 


6.1 Overview 


This chapter describes how to upgrade a VAXcluster environment. Refer 
to OpenVMS Cluster Systems for more detailed information on VAXcluster 
environments. 


If your cluster environment has both VAX and Alpha systems, you should also 
refer to the Migrating an Environment from OpenVMS VAX to OpenVMS Alpha. 


6.2 Concurrent and Rolling Upgrades 


There are two types of cluster upgrades: concurrent and rolling. The type of 
upgrade you use depends on whether you want to maintain the availability of the 
cluster during the upgrade and whether you have more than one system disk. 


6.2.1 Concurrent Upgrades 


During a concurrent upgrade, you must shut down the entire cluster and upgrade 
each system disk. No one can use the cluster until you upgrade each system disk 
and reboot each VAX computer. If all systems in the VAXcluster environment are 
booted from one system disk, you must perform a concurrent upgrade. 


Note 


For OpenVMS VAX Version 7.1 concurrent upgrades, all nodes in the 
cluster must be running at least OpenVMS VAX Version 6.1. (See 
Section 5.2.10 for more information.) 


To perform a concurrent upgrade, go to Section 6.38. 


6.2.2 Rolling Upgrades 


During a rolling upgrade, you can keep some of the VAX computers in the cluster 
running while you upgrade others (you must have more than one system disk). 
The cluster runs temporarily with different versions of the operating system. 


Note 


For OpenVMS VAX Version 7.1 rolling upgrades, all nodes in the cluster 
must be running at least OpenVMS VAX Version 6.1. (See Section 5.2.10 
for more information.) | 


To perform a rolling upgrade, go to Section 6.4. 
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6.3 Performing a Concurrent Upgrade 


You perform a concurrent upgrade by shutting down the entire cluster, upgrading © 
each system disk, and rebooting each VAX computer in the cluster. When the 
cluster reboots, each VAX computer will be running the upgraded version of the 
operating system. Users cannot access the cluster until you upgrade each system 
disk and reboot each VAX computer. 


6.3.1 Concurrent Upgrade Procedure 
To perform a concurrent upgrade, use the following procedure: 
1. Shut down the entire cluster by logging in to the SYSTEM account on each 


node locally, entering the following command, and choosing the CLUSTER_ 
SHUTDOWN option: 


$ @SYSSSYSTEM: SHUTDOWN 


2. If you have only one system disk for your cluster, go to step 3. 


If you have more than one system disk, select one to upgrade. 


Caution 


You cannot use the system disk that you usually use as the quorum disk 
to hold the save sets from the distribution kit. 


3. Perform a conversational boot of a single VAX computer from the system disk 
you will be upgrading. For more information about the conversational boot 
procedure, refer to the upgrade and installation supplement for your VAX 
computer. 


At the SYSBOOT> prompt, use the SHOW VOTES and SHOW EXPECTED_ 
VOTES command to display the current values of the parameters. Write 
these values down because you will need to restore them later. Set the 
VOTES and EXPECTED_VOTES values to 1 by entering the following 
commands: 


SYSBOOT> USE CURRENT 
SYSBOOT> SET VOTES 1 
SYSBOOT> SET EXPECTED VOTES 1 
SYSBOOT> CONTINUE | 


4. Upgrade the system disk, using the procedure in Chapter 7. 
If you have only one system disk, go to step 6. 


If you have more than one system disk, shut down the system that you just 
upgraded. Then repeat steps 2 through 4 to upgrade each system disk in the 
cluster. When you finish upgrading all of the system disks, go to step 6. 


6. Reboot each computer in the VAXcluster environment. 


Complete the postupgrade procedures described in Chapter 8. 
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6.4 Performing a Rolling Upgrade 


During a rolling upgrade, you upgrade each system disk individually, allowing 
old and new versions of the operating system to run together temporarily in the 
same cluster. Clusters running two versions of the operating system are called 
mixed-version clusters. Because rolling upgrades allow mixed-version clusters, 
the systems that you are not upgrading remain available. 


6.4.1 Restrictions 
The following restrictions apply to rolling upgrades: 


Digital recommends that all VAX computers in a cluster run the same version 
of the operating system. Mixed-version clusters are supported only for 

the purpose of upgrading the entire cluster incrementally. Digital further 
recommends that all VAX systems in a VAXcluster run the latest version of 
the OpenVMS VAX operating system. | 


A rolling upgrade does not apply when all systems boot from a single system 
disk. When all systems boot from a single system disk, perform a concurrent 
upgrade using the procedure described in Section 6.3. 


During the rolling upgrade, the queuing system is disabled on the nodes being 
upgraded. The queuing system on the other nodes should be unaffected by 
the upgrade as long as a START/QUEUE/MANAGER/ON=(upegrade node. . 

.) command is not executed. A START/QUEUE/MANAGER command could 
attempt to move the queue manager process to the node being upgraded if 
the /ON qualifier indicates that it is one of the preferred nodes. If the queue 
manager attempts to run on the node being upgraded, the queuing system 
will hang on the entire cluster. 


If your startup file contains a START/QUEUE/MANAGER/ON= Seas 
nodel, node2 ... noden) command, do not boot in any nonupgrading nodes 
until you have femibed that command from the startup file. Booting in a 
node will cause the queuing system to hang on the cluster if the START 
/QUEUE/MANAGER/ON=(upgrade node, ... ) command is executed. When 
the upgrade has completed, you can add the command back to the startup 
file. 


If the cluster queuing system hangs during the upgrade, it is most likely 
caused by the queue manager attempting to run on the upgrading node. To 
clear the condition, move the queue manager to a node you are not upgrading 
by entering the following command: 


START/QUEUE/MANAGER/ON=(nonupgrading nodel,- 
node2... noden) 


6.4.2 Rolling Upgrade Procedure 
To perform a rolling upgrade follow these steps: 


1. 


Check the votes and make adjustments to maintain the proper quorum so the 
cluster can continue to operate throughout the upgrade. (OpenVMS Cluster 
Systems describes this. procedure in detail.) 


Select a system disk to upgrade. 


Shut down all VAX computers booting from the system disk that you are 
upgrading, except for the computer that you will use to apply the upgrade. 


Upgrading a VAXcluster Environment 6-3 


Upgrading a VAXcluster Environment 
6.4 Performing a Rolling Upgrade 


VAX computers that do not boot from the system disk that you are upgrading 
remain available to users. | 


a. Log in to the SYSTEM account on the VAX computer you are shutting 
down. 


b. Enter the following command: 
$ @SYS$SYSTEM: SHUTDOWN. COM 


c. On one of the VAX computers that is still running, enter the following 
command: : 


$ SET CLUSTER/EXPECTED VOTES 


d. Repeat steps a through c for each VAX computer requiring a shutdown. 


This procedure lets one VAX computer continue running from the system 
disk (assuming computers running from different system disks supply enough 
votes to sustain cluster quorum). 


4. If proper quorum is not maintained at any time during the upgrade 
procedure, the shutdown procedure will hang the cluster. If the cluster 
hangs during a shutdown, enter the following commands on the system 
console of a CPU that is still a cluster member: 
$ 


>>> H 

>>> D/I 14 Cc 
>>> C 

IPC> Q 

IPC> 


5. Upgrade the system disk using the procedure in Chapter 7. 


Caution 


The upgrade procedure requires exclusive access to the drive that holds 
the distribution media. Do not mount the distribution media on other 
nodes. 


6. During phase 1 of the upgrade, the procedure will ask if you are performing 
a rolling upgrade. If you enter Y, the procedure asks you several questions 
to determine if all system disks in the cluster (other than the one you are 
upgrading) are running at least OpenVMS VAX Version 6.1. For example: 


* Are the other system disks running OpenVMS V6.1 or higher? 


All systems in the cluster must be running at least OpenVMS VAX Version 
6.1 to perform the rolling upgrade. Type Y and press the Return key. 


7. When the upgrade has completed, reboot each VAX computer that boots from — 
_the system disk you have just upgraded. 


Perform the postupgrade tasks described in Chapter 8. 


Repeat steps 2 through 7 for each system disk you are upgrading. Once you 
have performed tasks a through d in step 3, you do not need to perform them 
again. | 
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6.5 Adding an OpenVMS VAX Version 7.1 Supported CPU 


If you need to add a new CPU supported by OpenVMS VAX Version 7.1 to 
an existing Version 6.1 VAXcluster, Digital supports two options, listed in the 
following preferred order: 


1. Upgrade the entire cluster to OpenVMS VAX Version 7.1 and bring the new 
CPU in as a member. 


2. If you need to keep some systems in the cluster at OpenVMS VAX Version 
6.1, you must upgrade a system disk in the cluster to Version 7.1 using the 
rolling upgrade procedure and then boot the new CPU into the cluster using 
that system disk. 
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Upgrading the OpenVMS VAX Operating 
System 


7.1 Overview 


This chapter explains the procedure for upgrading a single OpenVMS VAX system 
disk, including: 


e How to prepare for booting from the [SYSF] directory 
e How to configure devices | 
e How to begin the upgrade 


e What the procedure does and what you are asked to do during the six phases 
of the upgrade 


You must complete each phase of the upgrade procedure. On most VAX computers 
the upgrade procedure continues automatically from phase to phase. Read the 
screen displays carefully and, if you need to reboot your VAX computer manually, 
refer to the upgrade and installation supplement for your VAX computer and 
Appendix C of this manual. 


The time required to complete an upgrade varies depending on your hardware 
configuration and on the distribution media you are using. In most cases, 
magnetic tapes and tape cartridges require more time than compact discs. 


Before you begin the upgrade procedure, read the overview of the upgrade 
procedure described in Chapter 1 and complete the preupgrade tasks described in 
Chapter 5. If you are upgrading a VAXcluster, you must also read Chapter 6. 


7.2 Preparing to Boot from [SYSF] 


During the upgrade procedure, you are asked to boot the system from the [SYSF] 
directory on the system disk. The [SYSF] directory is a root directory created 
on the system disk by the upgrade procedure. It temporarily holds the system 
files used in the upgrade until the procedure moves the files to their permanent 
location. The upgrade procedure then removes the [SYSF] directory from the 
system disk. 


If you do not know how to boot from [SYSF], read the upgrade and installation 
supplement for your VAX computer and Appendix C of this manual. 


Ignore any error messages after the first reboot that indicate an invalid dump 
header version. These messages are normal and are to be expected. | 
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7.2.1 Modifying Boot Command Procedures 


Some VAX computers require a special command eacectitite to boot from [SYSF]. 
If you are performing an upgrade on one of the following VAX computers you 
must modify the boot command procedures, DEFBOO and dddGEN before 
beginning the upgrade procedure: 


VAX 8530, 8550, 8700, 8810, 8820-N 
VAX 8820, 8830, 8840 


To modify the boot command procedures, exit from the OpenVMS VAX operating 
system (but do not shut it down) and enter the appropriate console mode. Make 
copies of DEFBOO and dddGEN before you modify them. Name the copies 
DEFBOO.SAV and dddGEN.SAV. | 


~The upgrade and installation supplement for your VAX computer describes 
the procedures for copying and modifying DEFBOO and dddGEN. Use these 
procedures to modify DEFBOO and dddGEN so that they specify [SYSF] as the 
directory from which to boot. 


In DEFBOO, change the DEPOSIT command that sets boot flags 1 in register 5 
(R5) as follows: 


DEPOSIT R5=F0000000 
In dddGEN, change the DEPOSIT command as follows: 
DEPOSIT R5 F0000001 | 


7.2.2 VAX 8200, 8250, 8300, and 8350 Computers 


_If you are upgrading a VAX 8200, 8250, 8300, or 8350 computer, you must create 
a boot command procedure that allows you to boot from the [SYSF] directory 
before beginning the upgrade. The upgrade and installation supplement for your 
VAX computer describes how to create this boot command procedure. 


7.2.3 Configuring Devices 


Because you rebooted your system with minimum startup, the system did not 
automatically configure all devices. However, you might need access to some of 
_ the devices to perform the upgrade. 


To make sure you can access the devices that might be needed for the upgrade, 
run SYSGEN to reconfigure the devices on the system and run STARTUP 
CONFIGURE by entering the following commands: 

$ RUN SYSSSYSTEM: SYSGEN 

SYSGEN> AUTOCONFIGURE ALL 


SYSGEN> EXIT 
$ @SYSSSYSTEM:STARTUP CONFIGURE 


7.3 i ie the Upgrade Procedure 


This section describes how to start the aperide procedure using VMSINSTAL. 
You can type a question mark (?) for help at any time while running 
VMSINSTAL. 


The instructions refer to the source drive and the target drive, where: 
e The source drive is the drive that holds the distribution kit. 
e The target drive is the drive that holds the system disk. 
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7.3.1 Step 1: Load Distribution Media 


Put the distribution compact disc or tape in the source drive. If your OpenVMS 
VAX distribution kit contains several tapes, put the first one in the drive. The 
paper labels on the tapes indicate the order in which you use them. 


If you are not using an InfoServer device, go to Section 7.3.3. 


If you are using an InfoServer device, proceed to the next step. 


7.3.2 Step 2: Upgrading from the InfoServer 
If upgrading from an InfoServer device, perform the following steps: 
1. Start the InfoServer Client software by entering the following command: 
$ @SYSSSTARTUP:ESSSSTARTUP CLIENT 


The CLIENT parameter loads the client driver, ESS$DADDRIVER.EXE, and 
the InfoServer transport driver, ESS$LASTDRIVER.EXE. 

2. As the startup procedure executes, it displays the following messages: 
$LASTCP-I-VERSION, LASTDRIVER X1.5 is stopped 
$LASTCP-I-ADAINIT, Initializing adapter xxx for LASTDRIVER 
$LASTCP-I-STARTED, LASTDRIVER X1.5 started on node yyy 


3. After you start the InfoServer Client software, you must make the compact 
disc drive accessible to your system by completing the following steps: 


a. Insert the distribution compact disc in the compact disc drive connected 
to the InfoServer. 
b. Enter the following commands: 
$ RUN SYSSSYSTEM:ESSS$LADCP 
LADCP> BIND/CONNECT/SYSTEM VAXVMS071 
sLADCP-I-BIND, service bound to logical unit DADSVMS071 (_DADn:) 
LADCP> EXIT 


Make note of the device name _DADn: in the previous display. You will have 
to specify this device name during the upgrade. 


7.3.3 Step 3: Start VMSINSTAL 
To start VMSINSTAL, use the following procedure: 
1. Login to the SYSTEM account. 
2. Enter the following command: 
$ @SYSSUPDATE: VMSINSTAL 
VMSINSTAL displays a message similar to the following, depending on which 


version of the operating system is currently running on your system: 


OpenVMS VAX Software Product Installation Procedure V7.0 
It is 22-NOV-1996 at 15:00.00.00 


Enter a question mark (?) at any time for help. 


VMSINSTAL checks your system’s account quotas. If it finds account quotas that 
are less than it expects, VMSINSTAL displays a message similar to the following: 
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SVMSINSTAL-W-LOWQUOTA, The following account quotas may be too low. 
-VMSINSTAL-W-LOWQUOTA, If you want to modify these account quotas, type NO to 
-VMSINSTAL-W-LOWQUOTA, the next question, modify the appropriate quotas, log out 
--VMSINSTAL-W-LOWQUOTA, then log back in and restart this procedure. | 


BYTLM: currently 32512; minimum expected 32768 


* Do you want to continue anyway [NO]? 


You should have verified that your SYSTEM account quotas were sufficient before 
beginning the upgrade. (See Section 5.6.8 for the minimum required values and 
for instructions for modifying quotas and limits.) 


To modify the account quotas now, do the following: 
1. Type No and press the Return key. 
2. Modify the account quotas you want to change. 


3. Log out of the SYSTEM account; then log back in so that the new nee will 
be in effect. 


4. Restart VMSINSTAL. 


To continue the upgrade without modifying the account quotas, type Yes and 
_ press the Return key. 


7.3.4 Step 4: Back Up the System Disk 
The procedure displays the following message: 


* Are you satisfied with the backup of your system disk [YES]? 


If you have made a standalone backup of the system disk, press Return and go to 
Section 7.3.5. 


If you have not made a standalone image backup of the system disk, do the 
following: 


1. Type N (for No) and press Return. VMSINSTAL ends and the dollar-sign 
prompt ($) is displayed. 


2. Back up the system disk as described in the upgrade and installation 
supplement for your VAX computer. 


3. After you have made a backup of the system disk, start the upgrade preceeuny 
again. 
7.3.5 Step 5: Specify the Source Drive 
VMSINSTAL asks for the name of the drive that holds the distribution media: 
* Where will the distribution volumes be mounted: 


Enter the device name of the source drive. For example, if you have a VAX 6000 
series computer that has a TK70 with a device name of MUC6, type MUC6 and 
press the Return key. 


If the drive is connected to an HSC, enter the HSC name and the device name of 
the drive separated by a dollar sign ($). (If you do not enter the device name in 

this manner, it will cause a failure in Phase 2.) For example, if the HSC name is 
MUTT and the device name is MUAO, enter the following and press Return: 


* Where will the distribution volumes be mounted: MUTTSMUA0 


If you are not using an InfoServer device, proceed to Section 7.3.6. 
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If you are upgrading from a compact disc drive connected to an InfoServer, the 
device name is DADn. The n part of the device name was displayed when you 
bound to the distribution compact disc as previously described in Section 7.3.2. 


If VMSINSTAL displays an error message, make sure the drive is connected and 
set up properly. Enter the name again. If VMSINSTAL displays another error 
message, use the following procedure to verify the device name: 


1. Press Ctrl/Y to exit from VMSINSTAL. 


2. Enter the SHOW DEVICE command to make sure you have the correct device 
name. 


3. Restart the upgrade procedure from Section 7.3.3. 
If VMSINSTAL does not display an error message, proceed to Section 7.3.6. 


7.3.6 Step 6: Enter Product Name 


When VMSINSTAL displays the following message, type VMS071 and press the 
Return key. Make sure that you use the number zero (not the letter “O”) when 
you type VMS071. For example: 


* Products: VMS071 
When the procedure displays the following message, press Return: 


* Enter installation options you wish to use (none): 


7.3.7 Step 7: Mount the First Volume 
VMSINSTAL displays a message similar to the following: 


Please mount the first volume of the set on MUAQ. 


When the procedure displays the following message, type Y (for Yes) S) and press 
Return: | 


* Are you ready? Y 
The procedure displays messages similar to the following: 
¢MOUNT-I-MOUNTED, VMS071 mounted on _MUAQ: 


The following products will be processed: 


OpenVMS V7.1 


After a slight pause, the procedure displays a message similar to the following: 


Beginning installation of OpenVMS V7.1 at 15:05 
$VMSINSTAL-I-RESTORE, Restoring product saveset A... 


7.3.8 Step 8: Monitor Messages from VMSINSTAL 


The upgrade procedure displays several important messages that provide you 
with the following information: 


— What VMSINSTAL is doing. 
— Notes, suggestions, and restrictions about various parts of the upgrade. 


— Status of the upgrade. 
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Read these messages carefully to decide whether or not you need to interrupt the 
upgrade procedure. An interruption is allowed before Phase 1. The procedure 
displays the following message: 


* Do you want to continue? (Y/N): 
To continue the upgrade, type Yes and press the Return ae 
To interrupt the upgrade, do the following: 
1. Type No and press Return. 
2. If prompted for another product, type EXIT to exit from VMSINSTAL. 


7.3.9 Step 9: Verify Date and Time 


The procedure displays the current date and time. If the date and time are 
correct, type Yes. If they are incorrect, type No. Enter the correct date and time 
using the 24-hour clock format and press Return. For example: 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH:MM) 22-NOV-1996 15:10 


7.4 Upgrade Phase 1 


This section describes Phase 1 of the upgrade. During this phase, you provide 
passwords for system accounts and select OpenVMS options, and the procedure 
restores the files in the OpenVMS required save set (VMS071.B). 


At the end of this phase, the procedure shuts down your VAX computer. If your 
computer uses console media when booting and the boot file was modified as 
described in Section 7.2, the system should reboot automatically. Otherwise, you 
must reboot manually from the SYSF directory. 


7.4.1 Step 1: Specify Type of Upgrade 
At the beginning of Phase 1, the procedure displays a message similar to the 
following: 
Upgrade Phase 1 22-NOV-1996 15:11:17.05 
* Are you performing a rolling upgrade? (Y/N): 


If you are performing a concurrent upgrade or an upgrade on a standalone 
system, type No and press the Return key. 


If you are performing a rolling upgrade, type Yes and press Return. The 
procedure will ask you several questions to determine if all system disks in 

the cluster (other than the one you are upgrading) are running at least OpenVMS 
VAX Version 6.0. Follow the instructions in Section 6.4. 


7.4.2 Step 2: Enter Passwords 


To ensure system security, the upgrade procedure requires you to enter passwords 
for the SYSTEM, SYSTEST, and FIELD accounts before continuing. Passwords 
must contain at least 8 characters; they are not displayed by the system. Press 
Return after you enter each password and it will be verified. For example: 


To help provide a more secure system, you are asked to enter passwords 
for key system accounts. Passwords must be a minimum of 8 characters 
in length. You can enter new or existing passwords. 


Enter passwords for the following accounts: 


SYSTEM, SYSTEST, FIELD 
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* Enter password for SYSTEM: 

* Re-enter for verification: 

tUAF-I-MDFYMSG, user record(s) updated 

sVMS-I-PWD OKAY, account password for SYSTEM verified 


* Enter Password for SYSTEST 

* Re-enter for verification: 

SUAF-I-MDFYMSG, user record(s) updated 

sVMS-I-PWD OKAY, account password for SYSTEST verified 


The SYSTEST CLIG account will be disabled. You must re-enable 
it before running UETP but do not assign a password. 


SUAF-I-MDFYMSG, user record(s) updated 


Enter password for FIELD: 

Re-enter for verification: 

$UAF-I-MDFYMSG, user record(s) updated 
$VMS-I-PWD-OKAY, account password for FIELD verified 


If you enter a password incorrectly or if the password is too easy to guess, the 
procedure displays error messages similar to the following: 


sVMS-W-PWD-INVALID, account password for FIELD is invalid 
$VMS-I-PWD-WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure’ this account. 
You must either disable this account, change its password, or do both. 


When the procedure asks if you want to disable the account, 
type No and press the Return key. When the procedure asks if you want to enter 
a new password, type Yes and press Return. Then enter a new password. For 
example: 
Do you want to disable the account (Y/N)? N 
Do you want to change the account password (Y/N)? Y 

~ You must now select a new primary password for the FIELD account. The 


password you select must be at least 8 characters in length and cannot be 
the same as the name of the account. 


New password: 

Verification: 

SUAF-I-MDFMSG, user record(s) updated 

$VMS-I-PWD-SET, primary password for account FIELD set 


After you have correctly entered the passwords, the procedure does the following: 


e Checks the account quotas in the DEFAULT, SYSTEM, and various other 
accounts and modifies them if necessary | 


e Turns off quotas on the system disk 
e Stops OPCOM 
e Stops the error formatter (ERRFMT) 


7.4.3 Step 3: Choose Boot Method 
If your VAX computer is not one of the following, go to Section 7.4.4. 


VAX-11/730 

VAX-11/750 

VAX-11/780 

VAX 8200, 8250, 8300, 8350 
VAX 8600, 8650 

VAX 9000 


| Upgrading the OpenVMS VAX Operating System 7-7 


rome ee the OpenVMS VAX sOperenng System 
7.4 Upgrade Phase 1 


If your VAX computer is included in the preceding list, the procedure can 
temporarily modify the DEFBOO.CMD (or DEFBOO.COM if you have a 

VAX 8600 computer) to boot from the [SYSF] directory. During Phase 4 of 

the upgrade, the procedure restores the DEFBOO.CMD (or DEFBOO.COM) file 
that is set up to boot from the current system disk and system root. 


The procedure displays a message similar to the following (except for VAX—11/730, 
11/780, and 8600 computers): 


* Do you want to boot from the [console media]? 


If you prefer to boot your system manually from the [SYSF] directory or if you 
are booting directly from a local system disk, type No, press the Return key, and 
go to Section 7.4.4 to continue the upgrade. 


Type Yes and press Return if one of the following is true: 
e You want to boot from the console media. 

e Your computer is a VAX—11/730, 11/780, or 8600. 

e You are using a CI750. 


The procedure prompts you to insert the console media in the drive. Insert the 
backup copy of the console media into the drive and do not remove it from the 
drive until the upgrade has been completed. Make sure the console media is 
write enabled. | 


7.4.4 Step 4: File Cleanup 
The procedure does the following: | 


e Checks for the location of the SYS$TIMEZONE.DAT file. which must now 
‘must be in the SYS$COMMON:[SYSEXE] directory. If the procedure 
finds this file in some other directory, it deletes it from that directory. 
Later, during the final phase of the upgrade, the procedure prompts you 
for the information it needs to create a ene oon E.DAT file in the 
SYS$COMMON:|[SYSEXE] directory. 


e Renames files found in SYS$SPECIFIC:[SYSMGR] and in 
SYS$COMMON:|SYSMGR] by adding OLD_SPECIFIC to the file extensions. 
For example, [SYSMGR]LOGIN.COM becomes [SYSMGR]LOGIN.COM_OLD_ 
SPECIFIC. (The file extensions are restored during Phase 6 of the upgrade 
procedure.) | 


e Cleans up the system disk by purging all accounting data files, operator logs, 
and the directory SYSERR. The procedure also deletes all JNL files in the 
root directory and its subdirectories. 


e Builds the directory tree [SYSF] and deletes the OpenVMS VAX and 
DECwindows files that are not needed to reboot during Phase 2 of the 
upgrade. 


As the procedure performs each of these tasks, it displays messages describing 
what is being done. When this step is completed, the protegure displays a 
message similar to the following: 


File cleanup complete - 22-NOV-1996 15:29:41.92 
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7.4.5 Step 5: Select Optional OpenVMS Components 


The procedure displays information about optional OpenVMS VAX files and the 
remaining amount of disk space. The information is similar to the following 
(block sizes might vary slightly): 


Select optional software you want to install. You can install one 
or more of the following OpenVMS or DECwindows components: 


OpenVMS library - 53400 blocks 
OpenVMS optional - 21200 blocks 
OpenVMS Help Message - 10200 blocks 
OpenVMS Management Station - 21200 blocks 
DECwindows base support - 3800 blocks 
DECwindows workstation support - 23500 blocks 

- 75 dots per inch video fonts - (included) 

- 100 dots per inch video fonts - 6000 blocks 
o DECnet-Plus networking - 85000 blocks 


00000 0 


Space remaining on system disk: 682440 blocks 


You must indicate which of the options you want to install. If you require network 
support, you must select the OpenVMS library component. 


Note that, if you do not install the optional OpenVMS components at this 

time, you can install them after the upgrade by using the VMSTAILOR and 
DECWS$TAILOR utilities. However, the Help Message utility and the three 
reference manuals can be tailored on to the system disk only. If you do not choose 
the Help Message files or the three manuals at this point in the procedure and 
want them on an alternate device, you will not be able to use VMSTAILOR to 
restore them later. If you want to install Help Message on an alternate disk after 
the installation procedure completes, you can use the BACKUP command, as 
follows: 


BACKUP/VERIFY source-device:[000000] VMS071.E/SAVE_SE'T- 
target-device:|(directory-name] 

For source-device, enter the device name for the drive on which the distribution 
media is mounted. For target-device, enter the device name on which the 
alternate disk is mounted, and for directory, enter the name of the directory to 
which you are copying the files. 


Also note that, for TK50 tape cartridges, it is quicker to install OpenVMS VAX 
software during the upgrade than to add software after the upgrade with a 
tailoring utility. For information about using VMSTAILOR, see Chapter 10. To 
select the options you want to install, follow the instructions displayed by the 
procedure. 


7.4.5.1 OpenVMS Library Files 
The procedure displays the following message: 
* Do you want to install the OpenVMS library files? (Y/N) 


The file subclasses of the OpenVMS library (VMS071.C) save set are listed 

in Appendix D. If you want to install the VMS071.C files, type Yes and press 
Return. If you require network support, you must select the OpenVMS library 
component. If you do not want to install the VMS071.C files, type No and press 
Return. 3 
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7.4.5.2 OpenVMS Optional Files 
The procedure displays the following message: 


* Do you want to install the OpenVMS optional files? (Y/N) 


The file subclasses of the OpenVMS optional (VMS071.D) save set are listed in 
Appendix D. If you want to install the VMS071.D files, type Yes and press Return. 
If you do not want to install the VMS071.D files, type No and press Return. 


7.4.5.3 Help Message Files | 
The procedure displays the following message: 


The Help Message utility (MSGHLP) provides online explanations 
and user actions for OpenVMS messages in place of the hardcopy 
OpenVMS System Messages and Recovery Procedures Reference Manual, 
which is now separately orderable. 


The MSGHLP database, MSGHLPSLIBRARY.MSGHLPSDATA, consumes 
approximately 10200 blocks and will be placed by default 

on your system disk in SYSSCOMMON:[SYSHLP] unless you specify an 
alternate device when prompted. 


Users with limited disk space can access the MSGHLP database 
on a read-only basis at DAD1:[HELP MESSAGE]. 


* Do you want to install the MSGHLP database? (Y/N) 


The Help Message utility is an online system for system messages documentation. 
You can install Help Message either on the system disk or on an alternate disk. 
If you want to install the Help Message files, type Yes and press Return. 


The procedure displays the following message: 


You can install this database on your system disk in SYSSCOMMON: [SYSHLP] 
or on an alternate device. If you specify an alternate device, but no 
directory, MSGHLPSLIBRARY.MSGHLPSDATA is placed in [HELP MESSAGE]. When 
prompted, take the default of the system disk or specify an alternate 
device using this format:: 


device: [directory] 
* Where do you want to install the MSGHLP database? [SYSSCOMMON: [ SYSHLP] ] DUAI 
The Help Message database is installed in the area you specified, and the system 
displays information similar to the following: 
$MOUNT-I-MOUNTED, VMS071 | mounted on DUAI1 


Space remaining on alternate device DUA1:: 124532 blocks 


7.4.5.4 OpenVMS Management Station Files 
The procedure displays the following message: 


The OpenVMS Management Station is a client-server application 
that provides OpenVMS system management capabilities through a 
client application on a personal computer (PC) running Microsoft 
Windows. The server application runs on OpenVMS systems and is 
automatically installed as part of the OpenVMS operating system. 


This option provides the files used to create the installation media 
for the PC client software. If you want to use the OpenVMS Management 
Station, you must install these files on at least one OpenVMS system to 
create the installation media, which can then be used to install the 
PC client on one or more PCs. 


Note: To use the OpenVMS Management Station on your PC, you must be 
running Digital’s PATHWORKS V5.0A for DOS and Windows (or V5.1) software. 


The OpenVMS Management Station optional files consume approximately 21200 
blocks and will be placed on your system disk in SYSSCOMMON:[TNT.CLIENT]. 
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* Do you want to install the optional OpenVMS Management Station files? (Y/N) 


Space remaining on system disk: 623240 blocks 


If you want to use the OpenVMS Management Station software, you must install 
these files. After the upgrade procedure completes, follow the instructions in 
Appendix G to prepare your OpenVMS system and your PC to run the OpenVMS 
Management Station server and client software. 


7.4.6 Step 6: Choose DECwindows Support Options 


Next, the procedure displays messages about the DECwindows components 
shipped with OpenVMS VAX Version 7.1. 


The OpenVMS VAX operating system no longer ships the OpenVMS DECwindows 
product. The operating system now ships only the DECwindows base support 
and DECwindows workstation support components. To get full DECwindows 
support, you must also install the separate DECwindows Motif for OpenVMS 
VAX (previously called VMS DECwindows Motif) layered product, which supports 
both Motif and XUI environments. 


Note that the DECwindows base support and DECwindows workstation support 
components are not shipped with the DECwindows Motif for OpenVMS layered 
product. If you want to install these options, you must select them now or use the 
DECW$TAILOR option after the installation procedure completes. 


Before you indicate whether you want to install DECwindows support software, 
consider the following: | | 


If you... Then choose... 

Intend to install the DECwindows Motif DECwindows base support. 
layered product 

Intend to install the DECwindows Motif DECwindows base support and 
layered product on a workstation or on a DECwindows workstation support. 


VAXcluster system that contains workstations 


Are not planning to install the DECwindows DECwindows base support and 
Motif layered product but are installing DECwindows workstation support. 
OpenVMS VAX on a workstation or on a 

VAXcluster that includes workstations 


Want to provide font files for X terminals DECwindows base support and 
DECwindows workstation support. 

Have a workstation monitor (for example, DECwindows base support and 

a VR150, VR160, or VR295) capable of DECwindows workstation support with 

displaying 100 dots/inch or a VAXstation the 100 dots/inch option. 


4000 series computer, which uses 100 dots 


. . . 1 k : 
/inch video fonts by default By selecting the workstation support 


files, you automatically get 75 dots/inch 
video font files, and you will be prompted 
to indicate if you want to install 100 
dots/inch video font files. 


The procedure displays the following: 


You can select DECwindows support now, or you can use the DECWSTAILOR utility 
to provide or remove DECwindows support after upgrade. 


Some media, TK50s in particular, can be very slow when tailoring on files. 
You might want to provide DECwindows options now and tailor off unwanted files later. 
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* Do 


* Do 


NOTE: This kit does NOT contain full DECwindows. 
To obtain full DECwindows support, you must also install the 
separate layered product, DECwindows Motif for OpenVMS VAX. 


Version 1.2-3 is the minimum version of DECwindows Motif for OpenVMS VAX 


that can be used with OpenVMS VAX Version 7.1. 


The DECwindows components provided in this kit require approximately 
29350 blocks, broken down as follows: 


o DECwindows base support = 3800 blocks 
© DECwindows workstation support = 23500 blocks 
- 75 dots per inch video fonts (included) 
- 100 dots per inch video fonts (optional) - 6000 blocks 


You must select the DECwindows base support option if 
- you plan to run DECwindows software, or 
- you are installing this kit on 
* a workstation or 
* a VAXcluster that contains workstations, or 
- you want to provide font files for Xterminals. 


If you are installing this kit on a system that includes Xterminals 
and you do not select DECwindows base support, then you will have to use 
the DECWSTAILOR utility to provide font files. 


you want the DECwindows base support? (Y/N) 
Space remaining: 619640 


You must select the DECwindows workstation support option if 
- you are installing this kit on 
* a workstation or 
* a VAXcluster that contains Gorkecabiona: or 
- you want to provide font files for Xterminals. 


If you are installing this kit on a system that includes Xterminals 
and you do not select DECwindows base support, then you will have to use 
the DECWSTAILOR utility to provide font files. 


you want to provide DECwindows workstation support? (Y/N) 
Space remaining: 598890 
DECwindows workstation support includes the 75 dots per inch video fonts. 


All DECwindows applications run with 75 dots per inch video fonts. 
By default, most systems start up with 75 dots per inch video fonts. 
Certain applications can take advantage of 100 dots per inch video fonts. 


For the VAXstation 4000 series machine, 100 dots per inch video fonts 
are used by default. If you decide not to install 100 dots per inch 
video fonts, you must edit SYSSMANAGER:DECWSPRIVATE SERVER SETUP.COM 
to force 75 dots per inch video fonts to be the default. Otherwise, 
certain applications may not space text properly. ; 


For instructions on how to configure your system with both 75 and 100 
dots per inch video fonts, see the template command procedure 
SYSSMANAGER:DECWSPRIVATE SERVER SETUP.TEMPLATE. 


*Do you want 100 dots per inch video fonts installed? (Y/N) 


Space remaining: 593890 
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Next, the procedure displays messages describing the DECnet options. 


information, refer to Section 1.2.1. 


Beginning with OpenVMS V7.1 DECnet-Plus is provided with the OpenVMS 
operating system. Digital strongly recommends that DECnet users 


install DECnet-Plus. DECnet Phase IV applications are supported 


by DECnet-Plus. 


If you plan to install DECnet Phase IV do NOT select DECnet-Plus. 


* Do you want to install DECnet-Plus. (Y/N) Y 


Space remaining on system disk: 508890 blocks 
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7.4.8 Step 8: Verify Your Choices 


The procedure displays a list of OpenVMS VAX and DECwindows support options 
that you have chosen and gives you the opportunity to change your mind before 
proceeding by displaying the following message: 


* Is this correct? (Y/N) 


If you answer Yes to this prompt, the procedure restores the OpenVMS required 
save set (VMS071.B) and purges the page, swap, dump, and authorization files. 


If you answer No to this prompt, you can respecify the OpenVMS VAX and 
DECwindows options that you want to install. The procedure restores the 
DECwindows components you have chosen during Phase 2. 


7.4.9 Step 9: Shut Down Your System 


After several minutes, the upgrade procedure indicates that the system will 
shut down to reboot the partially upgraded OpenVMS VAX system and displays 
information about how to reboot the system. 


On certain VAX computers, the procedure displays the following message: 
* Press RETURN to shutdown system: 


Once you have read the information displayed on the screen, press Return to 
begin the shutdown. 
7.4.10 Step 10: Reboot the System 


If your system uses console media, it should automatically reboot from the 
SYSF directory when the shutdown is complete. If you have a MicroVAX or 

if your system does not reboot from SYSF, halt the system and boot from the 
[SYSF] directory. For most MicroVAX and VAXstation computers, use the BOOT 
command in the following format and substitute the device name of the system 
disk for ddcu: 


>>> B/F0000000 ddcu 
If the system fails to boot, you can boot into SYSBOOT by entering the following: 
>>> B/F0000001 ddcu 


For more information on booting your computer from the SYSF directory, see the 
upgrade and installation supplement for your VAX computer. 


7.4.11 Step 11: Verify System Time 
When the system reboots, it displays a message similar to the following: 


OpenVMS VAX Version V7.1 Major version id = 1 Minor version id = 0 


System time is: 22-NOV-1996 15:54:08.30 


* Is that correct? (Y/N/?) 


eee Then... 
You want to redisplay the time Type a question mark (?) and press 
Return. 
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If... | Then... 


The system time displayed by the procedure is Type Yes and press Return. 
correct 


The system time displayed by the procedure is Type No and press Return. 


incorrect The procedure prompts you to enter the 


correct date and time. 


7.5 Upgrade Phase 2 


At the beginning of Phase 2, the procedure displays a message similar to the 
following: 


Continuing with OpenVMS VAX V7.1 Upgrade Procedure. 
Upgrade Phase 2 22-NOV-1996 15:55:42.57 


REE ERR RERERRERERRERREKERRE KERR RRR KRRERERKERRRKEKE 


$SYSTEM-W-TZGMT, your local timezone has defaulted to GMT 
$SYSTEM-I-SETTZ, to set your local timezone use: 


$ @SYSSMANAGER:UTCSTIME SETUP.COM 


KEKE ERR RRR RRR REE RERERRE RRR KRKERERKEREKREKEKE 


On MIN or UPGRADE system startup - CLUE is not run. 


22-NOV-1996 15:57:00.59 


You can ignore the time zone message. The UTC$TIME_ SETUP. COM procedure 
runs during the final phase of the upgrade procedure. 


7.5.1 What the Procedure Does 


During Phase 2, the upgrade procedure restores the rest of the library (C), 
optional (D), Help Message (E), and OpenVMS Management Station software (F) 
_ save sets and DECwindows support files if you elected to install them. 


7.5.1.1 Mounting Additional Tape Cartridge and 9-Track Open Reel Magnetic Tape Volumes 


If your distribution kit is on TK50 tape cartidges or 9-track open reel magnetic 
tapes, you may be asked to mount additional volumes of the kit. In such a case, 
your system will display a message similar to the following: 


Please mount volume <x> of the OpenVMS kit on <device> 


where: <x> is the volume number and <device> is the cartridge tape drive or 
open reel tape drive. 


After you respond to the prompt, the system displays one of the following 
messages: 


e For a TK50 tape cartidge, the message is similar to the following: 
* Is the volume labeled OVMS VAX V7.1 BIN TK50 2/2 ready to be mounted? 

e For 9-track open reel tape, the message is similar to the following: 
* Is the volume labeled OVMS VAX V7.1 BIN MT9 n/4 ready to be mounted? 
where: n/4 may be 2/4, 3/4 or 4/4. 

To respond to either message, do the following: 


1. Unload the volume currently in the drive. 
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2. Examine the remaining volumes and select the one with the label that 
matches the label specified in the prompt. 


3. Load the volume and make the drive ready. 
4. Answer YES to the question. 


For information on which save sets are located on which tape volumes, 
Section 1.4.1 and Section 1.4.2. 


7.6 Upgrade Phase 3 


At the beginning of Phase 3, the procedure displays a message similar to the 
following: 


Continuing with OpenVMS VAX V7.1 Upgrade Procedure 
Upgrade Phase 3 22-NOV-1996 16:45:18.35 


7.6.1 What the Procedure Does 
During Phase 3, the upgrade procedure does the following: 


1. Merges the OpenVMS VAX distributed files that are commonly edited by 
system managers with new OpenVMS VAX files. 


2. Merges all the miscellaneous user files in the old system directories 
into a new set of system directories, temporarily called SYSF.SYSEXE, 
SYSFE.SYSMGR, SYSF.SYSLIB, and so on. 


3. Removes the directory entries for page, swap, dump, and authorization files 
from the old directory tree. 


4, Deletes all the remaining accounting data files, operator logs, and all files in 
the SYSERR directory. 


5. Merges the old and new versions of the following files: HELP, DCLTABLES, 
IMAGELIB.OLB, and STARLET.OLB. | 


6. Moves all remaining files from the old directory tree (VMS$COMMON] to the 
new directory tree. 


7. Deletes the old directory tree (VMS$COMMON]. 


7.f Upgrade Phase 4 


At the beginning of Phase 4, the procedure displays a message similar to the 
following: 


Continuing with OpenVMS VAX V7.1 Upgrade Procedure. 
Upgrade Phase 4 | 22-NOV-1996 17:14:34.12 


7.7.1 What the Procedure Does 
| During Phase 4, the upgrade procedure does the following: 
1. Corrects back pointers for system directories. 
2. Shuts down the system. 


3. Reboots the system, or requires that you manually reboot the system. 
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7.7.2 What You Do 


If the procedure requires that you manually reboot the system from the original 
system root (usually SYSO), do the following: 


1. If you are upgrading a VAX 8530, 8550, 8810, or 8820-N computer, do the 
following: 


a. Restore the original copies of DEFBOO and dddGEN to boot from the 


original root directory. 


b. In the preupgrade procedure (Chapter 5), you made copies of the boot 
command procedures, DEFBOO.SAV and dddGEN.SAV. To restore the 
original names to these files, enter the following commands and press the 
Return key after each one: 
>>> EXIT 
S$ COPY DEFBOO.SAV DEFBOO.COM 
S COPY dddGEN.SAV dddGEN.COM 


2. For most MicroVAX and VAXstation computers, use the BOOT command in 


the following format and substitute the device name of the system disk for 
ddcu: 


>>> B ddcu 


If the system fails to boot, you can boot into SYSBOOT by entering the 
following: 


>>> B/1 ddcu 


For more information about booting your system, see the upgrade and installation 
supplement for your VAX computer. , 


When the system reboots, the procedure displays a message similar to the 
following: 


OpenVMS VAX Version 7.1 Major version id = 1 Minor version id = 0 


After the system reboots, the procedure continues with upgrade Phase 5. Do not 
move the system disk to a different drive. The system disk must remain in the 
same drive for the procedure to continue with Phase 5. 


7.8 Upgrade Phase 2) 


At the beginning of Phase 5, the procedure displays a message similar to the 
following: 


Continuing with OpenVMS VAX V7.1 Upgrade Procedure. 
Upgrade Phase 5 22-NOV-1996 17:45:24.03 


During Phase 5, the upgrade procedure does the following: 
1. Deletes the temporary [SYSF] directory tree. 
2. Cleans up files used only during the upgrade procedure. 


3. Converts all VAXVMSSYS. PAR parameter files found in system roots to 
Version 7.1 format. 


4. Displays messages listing tasks that you can perform after the upgrade 
procedure is completed. These tasks are described in Chapter 8. 
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7.9 Upgrade Phase 6 


At the beginning of Phase 6, the procedure displays a message similar to the 
following: 


Continuing with OpenVMS VAX V7.1 Upgrade Procedure. 
Upgrade Phase 6 22-NOV-1996 17:45:25.03 


Configuring all devices on the system... 


7.9.1 Restoring System Files 


The procedure restores SYS$SPECIFIC and SYS$COMMON versions of the 
following system files that were renamed with .COM_OLD_SPECIFIC and .DAT_ 
OLD_SPECIFIC extensions during Phase 1: 


SYSTARTUP_VMS.COM 
SYCONFIG.COM 
SYPAGSWPFILES.COM 
SYSECURITY.COM 
SYSHUTDWN.COM 

SYLOGIN.COM 

LOGIN.COM 

SYLOGICALS.COM 
AGEN$NEW_SATELLITE_DEFAULTS.DAT 
AGEN$NEW_NODE_DEFAULTS.DAT 
LAT$SYSTARTUP.COM 
TFFS$STARTUP.COM 


You might not have site-specific versions of all of these files. The procedure will 
display a message listing each file as it is restored. 


You might receive any of the following network messages, which can be ignored: 
$NCP-W-UNRCMP, Unrecognized component, Object 
Or: 
*NCP-I-SUCCESS, Success 
Object = X$x0 
$NML-I-RECDELET, Database entry deleted 
7.9.2 Registering Licenses 
The upgrade procedure also gives you the opportunity to register any additional 
licenses. 
The procedure displays the following message: 


If you have Product Authorization Keys (PAKs) to register, you can 
register them now. 


* Do you want to register any Product Authorization Keys? (Y/N): 


You do not have to reregister your OpenVMS VAX license or licenses for the 
following system integrated products: 


VAXclusters 
DECnet—Plus 
RMS Journaling 
Volume Shadowing 


If you want to register a new Product Authorization Key, type Yes and press the 
Return key. Otherwise, type No and press Return. 
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For more information on registering licenses, see the description of 
VMSLICENSE.COM in Appendix B and in the OpenVMS License Management 
Utility Manual. 


7.9.3 Updating Time Zone ‘ulation 


At this point in the upgrade, the procedure checks for the presence of time zone 
and time differential factor (TDF) files on your eyeten If it does not find one or 
the other of these files, the procedure prompts you for information to be used for 


providing local time zone support. 


For local time zone support to work correctly, the upgrade procedure must set 
the time zone that accurately describes the location you want to be considered 
as your default time zone. Usually, this is the time zone in which your system 
is running. In addition, your system must be correctly configured to use a valid 
OpenVMS time differential factor (TDF). 


The procedure displays a series of time zone menus and prompts you to make 
selections from those menus. The first menu is the main time zone menu. Select 
the time zone that best describes your location. If you do not select a time zone, 
the default is Greenwich Mean Time (GMT). 


Some time zone choices cause an additional menu to be displayed. This happens 
when the time zone you select has subcomponents. For example, if you choose the 
United States (US) time zone from the main menu, a second menu displays the 
specific time zones within the United States. You then select the menu item that 
best represents your local time zone. 


The procedure then prompts you for the TDF. The TDF is the difference 
between your system time and Coordinated Universal Time (UTC), which is 
an international standard for measuring time of day. You can choose from the 
following options: 


e Exit the time zone procedure without setting a TDF 
e Set a TDF | 
e Display the TDF for your local time zone 


For more information about TDF and local time zone support, see the OpenVMS 
System Manager’s Manual. 


7.9.4 Installing DECnet—Plus 


Earlier in the procedure, you were aeted whether you wanted to install the 
DECnet—Plus product. If you answered Yes, the procedure now installs it. 


Note that, if DECnet—Plus (formerly DECnet/OSD is already installed on your 
system and if the installed version is the same as or higher than the version 
supplied with OpenVMS VAX Version 7.1, then DECnet-—Plus is not reinstalled, 
and the procedure displays the following message: 


DECnet--Plus is already installed. 


If DECnet—Plus is not already installed on your system, the procedure displays 
a message similar to the following and prompts you for information it needs to 
install the DECnet—Plus product. In this example, the kit is being installed from 
an InfoServer device, DAD1. 
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DECnet-Plus will now be installed. 
Media containing the DECnet-Plus kit must be available. 


If you are installing OpenVMS from an InfoServer (DAD1) 
or local CD-ROM, there is a DECnet-Plus kit on the CD-ROM. 


If you are installing from a cartridge tape (TK50) or 
from an open reel tape, you should have a DECnet-Plus kit 
on cartidge tape or open reel tape. 


An appropriate DECnet-Plus kit may also be available on 
the Consolidated Distribution CD-ROM, or you may have a 
separate DECnet-Plus kit. 


NOTE: You may choose any available media for the 
DECnet-Plus kit. It is NOT NECESSARY to use the same 
type of media that contained the OpenVMS kit. 


* Enter name of drive holding the DECnet-Plus kit: DAD1: 
* Enter the InfoServer service name: OTHER PRODS 
* Enter the InfoServer work group number [0]: 


The following product has been selected: 
DEC VAXVMS DECNET PLUS V7.1 

*** DEC VAXVMS DECNET PLUS V7.1: DECnet-Plus V7.1 N3_H for OpenVMS VAX 
Copyright ) Digital Equipment Corporation 1996. All rights reserved. 
Digital Equipment Corporation 
This product requires one of two PAKs: DVNETEND or DVNETRTG. 
Do you want all the default values for this product? [YES] 
Do you want to view the values? [NO] 


Execution phase starting ... 
The following product will be installed: 
DEC VAXVMS DECNET PLUS V7.1 
Portion done: 0%...10%...20%...30%...40%...80%...90%...100? 
The following product has been installed: 
DEC VAXVMS DECNET PLUS V7.1 


7.9.5 Running AUTOGEN 
Next, the procedure displays the following message and runs AUTOGEN: 
Running AUTOGEN to compute the new SYSTEM parameters... 
If AUTOGEN encounters any problems, it displays the following message: 


tAUTOGEN-W-REPORT, Warnings were detected by AUTOGEN. Please review the 
information given in the file SYSSSYSTEM:AGENSPARAMS.REPORT. 


If AUTOGEN displays this message, be sure to check AGEN$PARAMS.REPORT 
as one of your postupgrade tasks. This task is described in Section 8.4. 


7.9.6 Shutting Down the System 


After AUTOGEN finishes, the procedure displays a sequence of shutdown 
messages that begins like this: 


The system is shutting down to allow the system to boot with the 
generated site-specific parameters and installed images. 


The system will automatically reboot after the shutdown and the 
upgrade will be complete. 


SHUTDOWN -- Perform an Orderly System Shutdown 
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The system shuts down and will reboot automatically if your system is set up to 
do so. If the system does not reboot automatically, reboot it manually. For more 
information on booting your system, see the upgrade and installation supplement 
for your VAX computer. 


7.9.7 Booting Voting Nodes 
If you are upgrading a standalone eveiea go to the next step. 
If you are upgrading a VAXcluster system, the system might hang when you try 
to reboot the upgraded system disk. This is because the total cluster value is less 
than the cluster quorum value. To remedy this situation, boot voting members 
that run from the system disk you just upgraded. (For more information about 


quorum values and voting members, see OpenVMS Cluster Systems.) All nodes 
that are booted at this time will run AUTOGEN and reboot. 


7.9.8 Executing STARTUP 


After the system reboots, the procedure displays the following message: 
KREEKRERRKEKREREKR ERR ER ERE RER RRR RRR RRR ERERKRKREREERREREKEKEKEKESE 

OpenVMS VAX V7.1 

You have SUCCESSFULLY installed the OpenVMS operating system. 


The system is now executing the STARTUP procedure. Please 
wait for the completion of STARTUP before logging in to the 
system. 


HRRKEKE HERE REE EER ERE RE ERE EKER ERE RRR RE REE ERERERERRRERE KS 


Finally, the procedure displays informational messages as well as accounting 
information. For example: 


SSTDRV-I-STARTUP, OpenVMS startup begun at 22-NOV-1996 18:27:30 


$SET-I-INTSET, login interactive limit=64, current interactive value = 0 


SYSTEM job terminated at 22-NOV-1996 18:30:00.00 

Accounting information: 
Buffered I/O count: 133 Peak working set size: 401 
Direct I/O count: 12 Peak virtual size: 2379 
Page faults: 325 Mounted volumes: 0 
Charged CPU time 0 00:00:55.23 Elapsed time 0 00:01:31.24 


At this point the OpenVMS VAX operating system is running. 
7.9.9 Logging In 


Press the Return key. The system asks for the user name and password. Log 
in to the SYSTEM account so that you can perform the postupgrade procedures 
described in Chapter 8. 

Welcome to OpenVMS VAX V7. : 


Username: SYSTEM 
Password: 


If you forget the password, follow the instructions for performing an emergency 
startup in the OpenVMS System Manager’s Manual: Essentials. 


Proceed to Chapter 8 to perform the required postupgrade tasks. 
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After Upgrading OpenVMS VAX 


After you upgrade the OpenVMS VAX operating system, you need to perform 
several important tasks before you can use the system. This chapter describes 
the following tasks in the order you perform them: 


Verifying system time 

Restoring the preferred node list 

Replacing SYSUAF.DAT and VMS$AUDIT_SERVER.DAT 
Examining AGEN$PARAMS.REPORT 

Checking the size of system files 

Examining your command procedures 

Changing MODPARAMS.DAT 

Updating your console media 

Decompressing system libraries 

Testing the system with UETP, the user environment test package 
Increasing free space on your system disk 

Purging system files | 

Restoring your modifications to the system password dictionary 
Customizing DECwindows support software 

Preparing to run the OpenVMS Management Station software 
Installing layered products 

Backing up the system disk 

Running AUTOGEN 

Completing the postupgrade checklist 


If you are an experienced system manager, you can use the checklist at the end of 
this chapter to complete the necessary postupgrade tasks. 


If you are a less-experienced system manager, you should read the entire chapter 
and then use the checklist to make sure you have completed all the postupgrade 
tasks. 


After Upgrading OpenVMS VAX 8-1 


After Upgrading OpenVMS VAX 
8.1 Verifying System Time 


8.1 Verifying System Time 


During the upgrade, the procedure displayed the system time and gave you the 
opportunity to enter the correct time if the displayed time was incorrect. 


Now that you have upgraded your system, verify that the system time is correct 
by entering the following command: 


S SHOW TIME 
The system displays the date and time. 


If the time displayed by your system is not correct, reset it by entering the 
command SET TIME using the following format: 


SET TIME=dd-mmm-yyyy:hh:mm:ss 
For example: 


S$ SET TIME=22-NOV-1996:18:353:30 


8.2 es the Preferred Node List 


After the upgrade completes, the queuing system on the upgraded nodes is 
enabled, and you must restore the preferred node list for the queue manager. 


To restore the preferred node list, enter the following command from any node: 
START/QUEUE/MANAGER/ON=(node1, node2. . . noden) 


For nodel, node2, and so forth, supply the names of the nodes—separated by 
commas—that you want to restore to the preferred node list. 


8.3 Replacing SYSUAF.DAT and VMS$AUDIT_SERVER.DAT 


If you permanently store the SYSUAF.DAT and VMS$AUDIT_SERVER.DAT files 
on the system disk, go to Section 8.4. 


If you do not permanently store SYSUAF.DAT and VMS$AUDIT_SERVER.DAT 
on the system disk, you copied them to the system disk before you did the 
upgrade. During upgrade procedure, these files were updated. 


Note 


If you did a rolling upgrade, the shared version of SYSUAF.DAT was not 
updated. 


To replace the updated files, copy the updated versions of SYSUAF.DAT and 
VMS$AUDIT_SERVER. DAT from the system disk to the directory where you 
usually keep them. 


8.4 Examining AGENSPARAMS.REPORT 


When AUTOGEN runs, it writes informational and, if necessary, warning 
messages to the file SYS$SYSTEM: AGEN$PARAMS. REPORT. You can view the 
contents of this report file to examine these messages. 
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To display AGEN$PARAMS.REPORT on your screen, enter the following 
command and press the Return key: 


$ TYPE SYSSSYSTEM: AGENSPARAMS .REPORT 


If the report includes a message similar to the following, you can modify the size 
of the PAGE, SWAP, or DUMP file: 


KEKKEKKEKEKEEKKKKKEKS 


SAUTOGEN-W-DSKSPC, The disk on which DISK$OpenVMS071: [SYS0.SYSEXE]PAGEFILE.SYS 
resides would be over 95% full if it were modified to hold 20000 
blocks. 


KEEKKKKEREEKREKEKEEEKEE 


For more information about modifying the sizes of the PAGE, SWAP, and DUMP 
files, see Section 8.5. 


8.5 Checking the Size of System Files 
AUTOGEN sets the following files at sizes appropriate for your system: 


[ISYSEXE]JSYSDUMP.DMP 
[SYSEXE]PAGEFILE.SYS 
[SYSEXE]SWAPFILE.SYS 


For special workloads or configurations, you can specify different sizes for these 
files. Check the sizes of these files to be sure they meet your needs. Log in to the 
SYSTEM account and enter the following command: 


S$ @SYSSUPDATE: SWAPFILES 


For more information, see the OpenVMS System Manager’s Manual: Essentials. 


8.6 Examining Your Command Procedures 


_ The upgrade procedure places a new version of WELCOME.TXT on your system 
disk. If your system uses a site-specific version of this file, you must modify the 
new version of the file with your changes. | 


The upgrade procedure restores your site-specific version of the following files 
with *.COM OLD SPECIFIC extensions: 


SYSTARTUP_VMS.COM 
SYCONFIG.COM 
SYPAGSWPFILES.COM 
SYSECURITY.COM 
SYSHUTDWN.COM 
SYLOGIN.COM 
LOGIN.COM 
SYLOGICALS.COM 
LAT$SYSTARTUP.COM 
TFF$STARTUP.COM 


The upgrade procedure provides new templates for some of these files with the 
.TEMPLATE extension. The new templates can include features that are not in 
your site-specific files. Check the templates against your site-specific files and 
edit your files as necessary. 


Remember, you do not need a START/QUEUE/MANAGER command in your 
startup file because the queue manager automatically starts up when you boot 
the system. 7 
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8.7 Changing MODPARAMS.DAT 


Review the file SYS$SYSTEM:MODPARAMS.DAT. The upgrade 
procedure created a new version of this file. The old version is named 
SYS$SYSTEM:MODPARAMS.DAT_OLD. eon the new file, if necessary, 
for your system. 


If you are upgrading a VAXcluster, you must update the MODPARAMS.DAT 
file for each VAX computer that boots from the system disk. Make sure the 
EXPECTED_VOTES value is correct. The value is the sum of all VOTES in the 
cluster. For example, if there are five VAX computers in the cluster, and each 

has one VOTH, the value is five. As you reboot each VAX computer, AUTOGEN 
runs automatically. The cluster forms when you have booted enough computers 
to attain cluster quorum. 


For more information, refer to the OpenVMS System Manager’s Manual: Tuning, 
Monitoring, and Complex Systems. 


8.8 Updating Your Console Media 


If your computer does not use console media, skip this section and go to 
Section 8.10. 


If your computer uses console media, you must copy the Version 7.1 VMB.EXE 
onto your system’s console media. The procedure for accomplishing this differs 
depending on the VAX series computer you have. Follow the instructions in the 
section that applies to your VAX computer. 


8.9 VAX 8530, 8550, 8810 (8700), 8820-N (8800) Computers 


If you upgraded a VAX 8530, 8550, 8810 (8700), or 8820-N (8800) computer, do 
the following: 


1. Place a blank RX50 diskette in one of the console diskette drives. The console 
refers to the upper (or left-hand) diskette drive as DZ1 while the OpenVMS 
VAX operating system refers to it as CSA1. The console refers to the lower (or 
right-hand) drive as DZ2 while the OpenVMS VAX operating system refers to 
it as CSAQ2. 


2. Make sure the diskette drives have been connected to the OpenVMS VAX 
operating system, as follows: 


$ SHOW DEVICE CSA 


Device Device Error Volume 
Name Status Count Label 
CSA0: (SYSTEM) Online 0 
CSA1: (SYSTEM) Online 0 
CSA2: (SYSTEM) Online 0 


If the drives are not connected, the following message is displayed: 


$SYSTEM-W-NOSUCHDEV, no such device available 


If this message is displayed, enter the following commands (you need 
CMKRNL privilege): | 

S RUN SYSSSYSTEM: SYSGEN 

SYSGEN> CONNECT CONSOLE 

SYSGEN> EXIT 


3. To initialize the diskette, enter a command in the following format: 


S INITIALIZE/STRUCTURE=1 device-name: volume-label 
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Substitute CSA1 or CSA2 for device-name. Substitute a 1- to 12-character 
name for volume-label. For example: 


$ INITIALIZE/STRUCTURE=1 CSA1: V61CONSOLE 


Enter the following commands to mount the diskette, create the required 
directories, and copy the new VMB.EXE to the diskette. Substitute CSA1 or 
CSA2 for device-name. 

$ MOUNT/OVERRIDE=ID device-name: 

S$ CREATE/DIRECTORY device-name: [ TRANSFER] 

S$ COPY SYSSSYSTEM:VMB.EXE device-name: [ TRANSFER] 


Once you have copied all the files, enter the following command to dismount 
the diskette. (Leave the diskette in the drive.) Substitute CSA1 or CSA2 for 
device-name. 


§ DISMOUNT device-name: 


To enter console mode, press Ctrl/P. To exit from the console program, enter 
the following command: 


>>> EXIT 


Open the diskette drive door, pause for a moment, and close it. The red 
indicator light will flash. 


To copy VMB.EXE from the diskette to the console fixed disk drive, enter the 
following command: 


$ COPY DZu:[TRANSFER]VMB.EXE LBOQ:[CONSOLE] 
Substitute DZ1 or DZ2 for DZu. 


The fixed drive in the console is known by two names, DW2 and LBO. Most 
console files are stored using the name LBO. If the system displays a message 
that describes a protection violation on the output device, copy the files using 
the device name DW2 rather than LBO. 


When you have finished copying the files, remove the diskette from the drive. 


Restart the console program by entering the following command and pressing 
Return: | 


$ RUN CONTROL 


Return to the operating system by entering the following command and 
pressing Return: 


>>> SET TERMINAL PROGRAM 


8.9.1 VAX-—11/730, 750, 780, 785 and VAX 8200, 8250, 8300, 8350, 8600, 8650 
Computers 


If you upgraded a VAX—11/730, 750, 780, 785 and VAX 8200, 8250, 8300, 8350, | 
8600, or 8650 computer, follow the instructions in this section. 


The procedure does the following: 


Checks to see if you have enough space for the new VMB.EXE 
Copies the new VMB.EXE to the console media 


Updates the BOOTS58 file for the VAX—11/750, 8200, 8250, 8300 and 8350 
computers 
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To update the console media, use the following procedure: 


I 
2. 


Log in to the SYSTEM account. 


Enter the following commands to check if there is enough space for the 
new VMB.EXE. You need 120 blocks. If you are updating a VAX—11/730 
system, use CSA2 for device-name; if you are updating one of the other VAX 
computers, use CSA1 for device-name. | 


$ RUN SYSSSYSTEM: SYSGEN 

SYSGEN> CONNECT CONSOLE 

SYSGEN> EXIT 

$ EXCHANGE DIRECTORY device-name: VMB.EXE 


Directory of RT-11 volume TINESSCSAI: 22-NOV-1996 18:40 
VMB.EXE 80 22-NOV-1996 | 
Total of 1 file, 80 blocks. Free space 43 blocks, largest 23. 


If the size of the current VMB, plus the free space, does not equal at least 
120 blocks, delete unneeded files on the console until you have 120 blocks 
available. In the above example, the size of the current VMB.EXE (80 blocks) 
plus the free space (43 blocks) equals 123 blocks, so files do not have to be 
deleted. | 


Enter the following command and press the Return key: 
$ @SYSS$UPDATE:UPDATE CONSOLE. COM 


If you are updating the console medium for a VAX 8600 or VAX 8650 
computer, the new VMB.EXE is copied onto the console medium. 


If you are updating the console medium for one of the other VAX computers, 
the procedure uses the EXCHANGE procedure to copy the contents of 

the existing console medium, merge the new files onto the copy of the console 
medium, and create a new version of the console medium. When the computer 
is ready to create the new version, it displays a message asking you to insert 
a scratch tape cassette or diskette. Take out the original console medium and 
insert a new one. 


8.9.2 VAX 9000 Computers 


VAX 9000 computers use a special version of VMB.EXE named VMB9AQ.EXE. 
The upgrade procedure automatically copies a new version of this file to the 
console hard disk. However, if for some reason you need to update the console 
hard disk, use the UPDATE_CONSOLE.COM command procedure described 
for the VAX—11/730, 750, 780, 785 and VAX 8200, 8250, 8300, 8350, 8600, 8650 
computers. The device name for the VAX 9000 console hard disk is CSA1. | 


8.10 Decompressing the System Libraries 


Decompressing the system libraries gives the system faster access to the libraries. 
You can decompress all the system libraries or just some of them. Table 8—1 gives 
the approximate number of blocks consumed by each library after decompression. — 
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Table 8-1 Sizes of Decompressed System Libraries 


Library Blocks Library Blocks 
HELPLIB.HLB 9108 EDFHLP.HLB 102 
STARLET.OLB 8442 TPUHELP.HLB 1038 
VAXCCURSE.OLB 102 ACLEDT.HLB 102 
VAXCRTL.OLB 477 INSTALHLP.HLB 102 
VAXCRTLG.OLB 102 LATCP$HELP.HLB 240 
DECCCURSE.OLB 102 MNRHELP.HLB 102 
DECCRTL.OLB 183 PATCHHELP.HLB 102 
DECCRTLG.OLB 102 PHONEHELP.HLB 102 
ERFLIB.TLB 105 SDA.HLB 111 
STARLETSD.TLB 4800 SHWCLHELP.HLB 150 
MAILHELP.HLB 273 SYSGEN.HLB 393 
EDTHELP.HLB 231 TECO.HLB 102 
DBG$UIHELP.HLB 408 UAFHELP.HLB 372 
DBG$HELP.HLB 1986 EVE$HELP.HLB 1197 
EXCHNGHLP.HLB 117 EVE$KEYHELP.HLB 147 
NCPHELP.HLB 537 STARLET.MLB 2502 
ANLRMSHLP.HLB 102 LIB.MLB 2229 
DISKQUOTA.HLB 102 


The additional amount of disk space required to decompress all system libraries 
is about 13,500 blocks. To find out how much disk space you have, enter the 
following command and press the Return key: 


$ SHOW DEVICE SYSSSYSDEVICE 


8.10.1 How to Decompress Libraries 


You execute the LIBDECOMP.COM command procedure to decompress the 
system libraries. To run LIBDECOMP, log in to the SYSTEM account, enter the 
following command, and press Return: 


$ @SYSSUPDATE: LIBDECOMP.COM 
The following information is displayed: 


OpenVMS Library Decompression Utility 


1 HELPLIB.HLB 14 NCPHELP.HLB 27 PATCHHELP.HLB 
2 STARLET.OLB 15 SDA.HLB 28 PHONEHELP.HLB 
3 ACLEDT.HLB 16 SHWCLHELP.HLB 29 LIB.MLB 

4 ANLRMSHLP.HLB 17 SYSGEN.HLB 30 STARLET.MLB 

5 DBGSHELP.HLB 18 ANALAUDITSHELP.HLB 31 STARLETSD.TLB 
6 DBGSUIHELP.HLB 19 SYSMANHELP.HLB 32 ERFLIB.TLB 

7 DISKQUOTA.HLB 20 TFFSTFUHELP.HLB 33 VAXCCURSE.OLB 
8 EDFHLP.HLB 21 EXCHNGHLP.HLB 34 VAXCRTL.OLB 

9 INSTALHLP.HLB 22 TPUHELP.HLB 35 VAXCRTLG.OLB 
10 LATCPSHELP.HLB 23 EVESHELP.HLB 36 IMAGELIB.OLB 
11 MAILHELP.HLB 24 EVESKEYHELP.HLB 37 DECCCURSE.OLB 
12 MNRHELP.HLB 25 UAFHELP.HLB 38 DECCRTL.OLB 
13. EDTHELP.HLB 26 TECO.HLB 39 DECCRILG.OLB 


A ALL libraries to be decompressed 
E EXIT this procedure 
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* Enter letter or number(s) of libraries to be decompressed 
(Separate multiple entries with a comma): 


Enter the appropriate letter or the numbers of the libraries you want to 


decompress. To decompress all libraries, the process takes approximately one 
half hour. 


If you prefer, you can execute LIBDECOMP interactively or as a batch job. If 
you use either of these methods, you can decompress up to 8 libraries each 

time you execute LIBDECOMP by 1 listing the names of the libraries you want 

to decompress as parameters on the command line. (You can decompress all 

the libraries by omitting the /PARAMETERS qualifier.) Be sure to separate the 
library names with commas and do not include the file extension. For example, to 
decompress the VAXCRTL.OLB, DISKQUOTA.HLB, and LIB.MLB libraries asa 
batch job, enter the following command: — 


$§ SUBMIT/NOTIFY/PARAMETERS= (VAXCRTL, DISKQUOTA, Be 
_$ SYSSUPDATE: LIBDECOMP 


To decompress these same libraries interactively, enter the following command: 
S$ @SYSSUPDATE:LIBDECOMP VAXCRTL DISKQUOTA LIB 


Note that, when you type the command for a batch job, you separate the library 
names with commas and enclose the list within parentheses. You do not use 
commas or parentheses on the interactive command line. 


8.11 Testing the System with UETP 


UETP, the user environment test package, is a software package that tests 
whether the OpenVMS VAX operating system is installed correctly. As part of the 
postupgrade procedure, you should run UETP to verify your upgrade. 


Note that UETP needs at least 1200 free blocks on the system disk and is 
available only if you installed the optional save set VMS071.D. If you did not 
install the optional save set, you can add the UETP files to your system using 
VMSTAILOR. For information about using VMSTAILOR, see Chapter 10. 


For complete information about UETP, see the OpenVMS System Manager's 
~ Manual: Tuning, Monitoring, and Complex Systems. 


8.12 Increasing Free Space on the System Disk 


This section describes how to increase the amount of free space on your system 
disk. You can gain free space by removing optional OpenVMS VAX files that you 
do not need from the system disk or by purging old versions of some system files. 


8.12.1 Using VMSTAILOR and DECW$TAILOR 


To remove files you do not need from the system disk, use VMSTAILOR. For 
example, if you are not running DECnet for OpenVMS, you do not need the 
network support files. For complete information about using VMSTAILOR to 
remove files, see Chapter 10. 


If you are running DECwindows Motif, use DECW$TAILOR to add or remove 
DECwindows base support, workstation support, and fonts. 


Note 


Files installed on alternate devices cannot be tailored. 
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8.12.2 Purging System Files 


In most cases, you can purge the following OpenVMS system files to free space on 
your system disk. However, before you purge any of these files, read Appendix F 
to make sure you do not purge a file version you might want to keep. 

SYSSSYSTEM: SHUTDOWN . COM 

SYSSSYSTEM: STARTUP .COM 

SYSSLIBRARY : ENCRYPSHR.EXE 

SYSSLIBRARY : *RTL* .EXE 

SYSSLIBRARY : *SHR.EXE 

SYSSMANAGER:EDTINI .EDT 

SYSSMANAGER : DBLSTRTUP .COM 

SYSSMANAGER: * . TEMPLATE 

SYSS$EXAMPLES: XADRIVER.MAR 

SYS$LIBRARY : CDDSHR. EXE 

SYSSLIBRARY: EPCSFACILITY.TLB 

SYSSMESSAGE: EPCSMSG. EXE 

SYSSSTARTUP : VMSSLAYERED. DAT 


To purge a file, enter the PURGE command followed by the file specification. For 
example: | 


$ PURGE SYSSSYSTEM: SHUTDOWN. COM 


8.13 Restoring Your System Password Dictionary 


The OpenVMS VAX operating system screens potential passwords for 
acceptability. The DCL command SET PASSWORD takes the user’s proposed 
password, converts it to lowercase (if necessary), and compares it to entries in 
a system dictionary. If the proposed password is found in the dictionary, it is 
rejected as a valid user password, and the user must suggest another. Many 
system managers modify the system password dictionary to include words of 
significance to their site. 


During the upgrade, the procedure replaces the existing system password 
dictionary with a new one. If you had modified the dictionary and want to restore 
your local additions, you must merge the file containing your additions with the 
new system file. 


To add your site-specific passwords to the new system password dictionary, enable 
SYSPRV and merge your local additions by entering the following commands, 
where LOCAL_PASSWORD_DICTIONARY.DATA is the file that contains your 
additions: 


$ SET PROCESS/PRIVILEGE=SYSPRV 


$ CONVERT/MERGE/PAD LOCAL PASSWORD DICTIONARY.DATA - 
_5 SYS$LIBRARY:VMSSPASSWORD DICTIONARY .DATA 


8.14 Customizing DECwindows Support Software 


If you have installed DECwindows support software, there are several steps that 
you can take to customize the DECwindows environment. Depending on your 
configuration, DECwindows customization tasks include the following: 


. @ Customizing the server startup 


e Using the Transmission Control Protocol/Internet Protocol (TCP/IP) as a 
DECwindows transport 


e Using transports for DECwindows other than those supplied by Digital 
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Go to Chapter 9 for complete instructions for customizing your DECwindows 
support software. 


After you complete the tasks described in Chapter 9, return to this eoepeees to 
continue with the remaining postupgrade tasks. 


8.15 Preparing to Run the OpenVMS Management Station 


The OpenVMS Management Station client-server software provides OpenVMS 
system management capabilities through a client application on a personal 
computer (PC) running Microsoft Windows. 


When you upgraded your OpenVMS system, the OpenVMS Management Station 
server files were automatically installed on your OpenVMS system disk. However, 
to obtain complete support, you had to select the OpenVMS Management Station 
client software files during the OpenVMS upgrade procedure. Those files are 
required for. creating the installation media that you use to install the client 
software on your PC. 


Appendix G provides complete instructions for preparing your OpenVMS system 
and your PC to run the OpenVMS Management Station software. 


Note 


If you did not select the optional OpenVMS Management Station client 
software files during the installation or upgrade, you must add these 
files to your OpenVMS system disk before you follow the instructions 
in Appendix G. Use the OpenVMS Version 7.1 distribution media and 
VMSTAILOR to add the OpenVMS Management Station files to your 
system. (For information about using VMSTAILOR, see Chapter 10.) 


8.16 Installing Layered Products 


Back up your system disk and then use either the VMSINSTAL command 
procedure or the POLYCENTER Software Installation utility to install layered 
products on your system. 


For additional information about installing layered products, see the OpenVMS 
System Manager’s Manual. 


8.16.1 TCP/IP Services for OpenVMS 


If you installed the Digital TCP/IP Services for OpenVMS software during the 
installation or if you choose to install it now as a layered product, note that you 
must also install the mandatory security update kit included with this release. 


The Digital TCP/IP Kit and the mandatory Security Update Kit are available in 
_ the following directory on the OpenVMS VAX CD-ROM: 


[TCPIP VAX 041] 


If you choose to install the Digital TCP/IP Services for OpenVMS software, you 
must install both kits. 
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8.17 Backing Up the System Disk 


Digital recommends that you protect your work by performing the following 


operations: 
e Use SYS$SUPDATE:CONSCOPY.COM to back up the console media (if 
applicable). 


e Make a standalone BACKUP kit on removable media and on the system disk. 


If your console media is a TU58 tape cartridge or an RX01 diskette, use the 
standalone BACKUP copy you made before you began the upgrade. (See 
Section 5.5.2.) 


e Back up the system disk. 


For complete information about these operations, see the upgrade and installation 
supplement for your VAX computer. 


8.18 Running AUTOGEN 


When you upgraded the OpenVMS VAX operating system, the procedure executed 
AUTOGEN to set the values of system parameters and the sizes of the page and 
swap files according to the system’s workload. 


In many cases, AUTOGEN can improve system performance by using dynamic 
feedback information from the running system. As a postinstallation task, you 
should run AUTOGEN again using the feedback mechanism to make further 
adjustments to system parameters. 


When AUTOGEN runs after an upgrade, it uses the parameter values 

in SYS$SYSTEM:MODPARAMS.DAT. Note that hardcoded values in 
MODPARAMS.DAT affect AUTOGEN’s calculations of the feedback parameters. 
For AUTOGEN to properly calculate minimum values, you should replace the 
hardcoded values in MODPARAMS.DAT with MIN_ values. The MIN_ prefix 
specifies the minimum value to which a parameter can be set by AUTOGEN. 


If you are not satisfied with the parameter settings calculated by AUTOGEN, 
you can modify the parameter values by editing MODPARAMS.DAT as explained 
in the OpenVMS System Manager’s Manual: Tuning, Monitoring, and Complex 
Systems. 


After you have upgraded the operating system, run AUTOGEN again using the 
following procedure: 


1. After 24 hours of operation, run AUTOGEN in feedback mode and reboot the 
system. 


2. Run AUTOGEN in this same way, again, two working days later. 


i Note 


For the VAX 9000 computer, AUTOGEN’s initial parameter calculations 
are conservative. To obtain parameter values that match your system 
workload, you can run AUTOGEN in feedback mode a number of times. 
For more information, see the upgrade and installation supplement for 
your VAX 9000 computer. 
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3. 


Digital recommends that you run AUTOGEN from SAVPARAMS through 
TESTFILES on a weekly basis and examine AGEN$PARAMS.REPORT to 
determine the need for additional changes. 


For information about using AUTOGEN, see the OpenVMS System Manager's 
Manual: Tuning, Monitoring, and Complex Systems. _ 


8.19 Postupgrade Checklist 


Use the following checklist to make sure you perform all the necessary 
postupgrade tasks. 


UO UUU YUUeU UO 


ee ey 2 ee 


Verify the system time. (Described in Section 8.1.) 


Restore the preferred node list for the queue manager. (Described in 
Section 8.2.) 


Replace SYSUAF.DAT and VMS$AUDIT_SERVER.DAT. (Described in 
Section 8.3.) 


Examine AUTOGEN output stored in the file AGEN$PARAMS.REPORT. 
(Described in Section 8.4.) 


Examine the command procedure templates supplied with OpenVMS VAX 
Version 7.1. (Described in Section 8.6.) 


Examine MODPARAMS.DAT? (Described in Section 8.7.) 
Update your console media. (Described in Section 8.8.) 


Decompress the system libraries using LIBDECOMP.COM. (Described in 


Section 8.10.) 


Run UETP (the user environment test package) to test the system. (Described 
in OpenVMS System Manager’s Manual: Tuning, Monitoring, and Complex 
Systems.) 


Remove unwanted files and check the sizes of system files. (Described in 
Section 8.12.) | 


Restore your local additions to the system password dictionary. (Described in 
Section 8.13.) 


Customize your DECwindows environment. (Described in Section 8.14.) 
Build a standalone BACKUP kit. (Described in Section 8.17.) 

Back up the qonnole media: (Described in Section 8.17.) 

Install layered products. 


Back up the system disk.. (Described in the upgrade and installation 
supplement for your computer.) 


Run AUTOGEN and reboot the system after the first 24 hours of operation. 
(Described in Section 8.18.) 
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9.1 Overview 


This chapter describes how you can customize DECwindows support software. 
The DECwindows components provided on the OpenVMS VAX kit supply 
DECwindows base support and workstation support files only. If you have not 
installed either of these DECwindows components on your system, skip this 
chapter. 


Depending on your configuration, DECwindows customization tasks include the 
following: 


e Customizing the server startup 


e Using the Transmission Control Protocol/Internet Protocol (TCP/IP) as a 
| DECwindows transport 


e Using transports with DECwindows other than those supplied by Digital 


Note that the OpenVMS VAX operating system no longer includes the VMS 
DECwindows product. To get full DECwindows support, you must also install the 
separate DECwindows Motif for OpenVMS VAX layered product, which supports 
both the Motif and XUI environments. 


9.2 Customizing the Server Startup 


By default, the DECwindows server no longer logs successful connect/disconnect 
messages to the DECW$SERVER_#_ERROR.LOG file. To enable these messages, 
define the symbol DECW$SERVER_CONNECT_LOG in the DECW$PRIVATE_ 
SERVER_SETUP.COM file to be "T" and restart the server. Note that abnormal 
or unsuccessful connect/disconnect messages are still logged by the server. 


9.2.1 Assumptions 


The startup command procedures automatically determine most of the 
configuration variables for the DECwindows display server. However, there 
are items that the command procedures cannot determine, so they make the 
following assumptions: 


e The startup procedures normally assume that you have a 75 dots/inch monitor 
(such as a VR260 or VR290). However, if you are installing on a VAXstation 
4000, the startup procedures assume that you have a 100 dots/inch monitor. 


e If you have a GPX, SPX, or LCG workstation, the startup procedures assume 
that you have a color monitor. 


e The startup procedures normally assume that you have a North American 
_keyboard layout (you have an LK201—AA or an LK201-LA keyboard). If you 
are installing on a VAXstation 4000, the startup procedures assume that you 
have an LK401—AA keyboard. 
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e The startup procedures assume that the server will use only DECnet software 
and local transports. — 


9.2.2 How to Override Incorrect Assumptions | 


If any of these assumptions is incorrect, you must override them as follows: 


1. Make a copy of the file SYSSMANAGER:DECW$PRIVATE_SERVER_ 
SETUP.TEMPLATE and rename it to a .COM file type. The comments in 
this file show how to customize individual workstations by adding a section 
of DCL commands for each workstation. You can also add DCL commands 
to the common section of the server startup file. By doing this, you ensure 
that the customizations you make affect all workstations that use the server 
startup file. | 


2. If your screen supports 100 dots/inch, add the following line: 
$ DECW$SERVER_DENSITY == "100" | 


Add this line to the section for each workstation that has a 100 dots/inch 
monitor, or add it to the common section for all workstations (if all the 
workstations have 100 dots/inch monitors). 


3. If you have upgraded to a VAXstation 4000 but still have a 75 dots/inch 
monitor, add the following line: 


$ DECWSSERVER_DENSITY == "75" 


4. The section for any workstation with color graphics and a monochrome screen 
should contain the following lines: 


$ DECWSCOLOR == "FALSE" , 
$ DECWSBITONAL == "FALSE" 


5. To override the default keyboard layout, determine the correct name from the 
model number of your LK201 keyboard, as follows: 


a. Turn the keyboard upside down, and look for a label that specifies the 
model number. The model number should be in a format similar to 
LK201-xx. | 


If the model number is listed as LK201 without any additional characters, 
the information you need is on another part of the label. Look for a 
number that has the following format: : 


nn-nnnnn—xx. 


b. Use the xx part of this number to choose a keymap name from Table 9-1. 
The table is arranged based on the dialect that each keyboard is designed 
for. Choose the keymap ending in _DP for the data processing keyboard 
layout, or the keymap ending in _TW for the typewriter layout. 


9-2 Customizing DECwindows Support Software 


Customizing DECwindows Support Software 
9.2 Customizing the Server Startup 


Table 9-1 DECwindows Keymap 


Dialect Model DECwindows Keymap Name 
Austrian/German LK201-(AG,LG,BG,MG) AUSTRIAN_GERMAN_LK201LG_DP 
AUSTRIAN_GERMAN_LK201LG_TW 
LK201-(NG,PG) AUSTRIAN_GERMAN_LK201NG_DP 
AUSTRIAN_GERMAN_LK201NG_TW 
LK401-(AG) AUSTRIAN_GERMAN_LK401AG_TW 
Belgian/French LK201-(AP,LP,BP,MP) BELGIAN_FRENCH_LK20 1LP_DP 
BELGIAN_FRENCH_LK201LP_TW 
Belgian/French LK401-(AP) BELGIAN_FRENCH_LK401AP_DP 
BELGIAN_FRENCH_LK401AP_TW 
British LK201-(AE,LE,BE,ME) BRITISH _LK201LE_DP 
BRITISH LK201LE_TW 
British LK401-(AA,PA) BRITISH _LK401AA_DP 
BRITISH_LK401AA TW 
Canadian/French LK201-(AC,LC,BC,MC) CANADIAN_FRENCH_LK201LC_DP 
CANADIAN _FRENCH_LK201LC_TW 
Canadian/French LK401-(AC,LC,BC,MC) CANADIAN _FRENCH_LK401AC_DP 
CANADIAN_FRENCH_LK401AC_TW 
Czech LK401-(BV) CZECH_LK401AV 
Danish LK201-(AD,LD,BD,MD) DANISH_LK201LD_DP 
DANISH_LK201LD_TW 
LK201-(ED,RD,FD) DANISH_LK201RD_DP 
| DANISH_LK201RD_TW 
Danish LK401-(AD,LD,BD,MD) DANISH_LK401AD_DP 
DANISH_LK401AD_TW 
Dutch LK201-(AH,LH,BH,MH) DUTCH_LK201LH_DP 
DUTCH_LK201LH_TW 
LK201-(NH,PH) DUTCH_LK201NH 
LK401-(NH,PH) | DUTCH_LK401AH 
Finnish LK201-(AF, LF,BF,MF) FINNISH_LK201LF_DP 
| FINNISH_LK201LF_TW 
LK201-(NX,PX) FINNISH_LK201NX_DP 
FINNISH_LK201NX_TW 
Finnish LK401-(AF,LF,BF,MF) FINNISH_LK401AF_DP 
FINNISH_LK401AF_TW 
Flemish LK201-(AB,LB,BB,MB) FLEMISH_LK201LB_ DP 
FLEMISH_LK201LB_TW 
Flemish LK401-(AB,LB,BB,MB) FLEMISH_LK401AB DP > 


FLEMISH_LK401AB_ TW — 


(continued on next page) 


Customizing DECwindows Support Software 9-3 


Customizing DECwindows Support Software 
9.2 Customizing the Server Startup | 


Table 9—1 (Cont.) DECwindows Keymap 


Dialect 


Hungarian 


Icelandic 


Italian 


Italian 


North American 
North American 


Norwegian 


Norwegian 
Polish 
Portuguese 
Portuguese 
Russian 
Slovakian 
Spanish 


Spanish 


Swedish 


Swedish 


Swiss/French 


Swiss/French 


Swiss/German 


‘Swiss/German 


Model 


LK401-(BQ) | 
LK201-(AU,LU,BU,MU) 


LK201(ALLLBLMD 
LK401-(Al,LLLBLMD 
LK201-(AA,LA,BA,MA) 
LK401-(AA,LA,BA,MA) 


LK201-(AN,LN,BN,MN) 


LK201-(EN,RN,FN) 


‘LK401-(AN,LN,BN,MN) 


LK401-(BP) 
LK201-(AV,LV,BV,MV) 
LK401-(AV,LV.BV.MV) 
LK401-(BT) 

LK401-(CZ) 
LK201-(AS,LS,BS,MS) 
LK401-(AS,LS,BS,MS) 
LK201-(AM,LM,BM,MM) 
LK201-(NM,PM) 
LK401-(AM,LM,BM,MM) 
LK201-(AK,LK,BK,MK) 
LK401-(AK,LK,BK,MK) 


LK201-(AL,LL,BL,ML) 


LK401-(AL,LL,BL,ML) 
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DECwindows Keymap Name 


HUNGARIAN_LK401_BQ 


~ ICELANDIC_LK201LU_DP 


ICELANDIC_LK201LU_TW 
ITALIAN_LK201L1_DP 
ITALIAN_LK201L1_TW 
ITALIAN_LK401AI_DP 
ITALIAN_LK401AI_TW 


NORTH_AMERICAN_LK201LA 


NORTH_AMERICAN_LK401AA 
NORWEGIAN_LK201LN_DP 
NORWEGIAN_LK201LN_TW 
NORWEGIAN_LK201RN_DP 
NORWEGIAN_LK201RN_TW 
NORWEGIAN_LK401AN_DP 
NORWEGIAN_LK401AN_TW 
POLISH_LK401_BP 
PORTUGUESE_LK201LV 
PORTUGUESE_LK401AV 
RUSSIAN_LK401_BT 
SLOVAK _LK401_CZ 
SPANISH _LK201LS_ DP 
SPANISH LK201LS_TW 
SPANISH _LK401AS DP 
SPANISH _LK401AS TW 
SWEDISH _LK201LM_DP 
SWEDISH _LK201LM_TW 
SWEDISH_LK201NM_DP _ 
SWEDISH_LK201NM_TW 
SWEDISH _LK401AM_DP 
SWEDISH _LK401AM_TW 


SWISS_FRENCH_LK201LK_DP 
SWISS_FRENCH_LK201LK_TW 
SWISS_FRENCH_LK401AK_DP 
SWISS_FRENCH_LK401AK_TW 
SWISS_GERMAN_LK201LL_DP 
SWISS_GERMAN_LK201LL_TW 
SWISS_GERMAN_LK401AL_DP 
SWISS_GERMAN_LK401AL_TW 
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Table 9-1 (Cont.) DECwindows Keymap 


Dialect 


Combined US/UK 


Combined US/UK 


Model DECwindows Keymap Name 
LK201-(EE,RE,PE) UK_LK201RE 

US_LK201RE 
LK401-(KE,RE,PE) UK_LK401AA 

US_LK401AA 


c. After you choose a keymap name, modify the server startup file. For 
example, to change the keyboard layout to a Dutch typewriter layout, add 
the following line to the server startup file: 


> DECWSDEFAULT KEYBOARD MAP == "DUTCH LK201LH TW" 


Add a line similar to this for each workstation that does not have a 
North American keyboard layout, or add it to the common section for all 
workstations (if all the workstations use the same keyboard layout). 


To add support for the Transmission Control Protocol/Internet Protocol 
(TCP/IP) transport using the DEC TCP/IP Services for OpenVMS product, 
add the following line: 


® DECWSSERVER TRANSPORTS == "DECNET, LOCAL, TCPIP" 


Add this line to the section for each workstation that will be using TCP/IP, or 
add it to the common section for all workstations. 


To include support for other transports, add the last part of the transport 
image name to the list of transports. For example, suppose you want to add 
support for a customer-written transport that has the following image name: 


SYS$SHARE:DECW_TRANSPORT_FOO 

You would add the following line: 

$ DECWSSERVER TRANSPORTS == “DECNET, LOCAL, FOO" 

Reboot the workstations for which you customized the server startup. 


Customize security as described in the Using DECwindows Motif for 
OpenVMS manual. 


After you start the server, a per-server logical name table is created on your 
system but is not added to the default logical name table search lists. 


9.3 vee Digital TCP/IP Services for OpenVMS 


DECwindows contains support for the TCP/IP transport. This support requires 
Digital TCP/IP Services for OpenVMS, a Digital layered product. Before you can 
use the DECwindows TCP/IP transport interface, you must install Digital TCP/IP 
Services for OpenVMS. 


Note 


Other vendors’ implementation of TCP/IP transports use different 
call interfaces. For this reason, DECwindows support for TCP/IP is 
compatible only with Digital TCP/IP Services for OpenVMS. 
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You can conserve memory and process slots by configuring Digital TCP/IP 
Services for OpenVMS software for the minimum DECwindows requirement to 
support the X protocol. DECwindows only requires that IN ET_ACP be running. 
DECwindows does not require that the NFS server, the FTPD server, or the 
remote terminal servers be running. 


For more information about TCP/IP concep see the Digital TCP/ IP Services for | 
OpenVMS: Management manual. | 


For information on how to configure the TCP/IP software, see the Digital TCP/IP 
Services for OpenVMS: Installation and Basic Configuation manual. 


9.4 Using Other Transports with DECwindows 


DECwindows supports DECnet—Plus, local, and 

TCP/IP transports. However, you can use other transports, such as new 
transports for layered products and transports from third-party vendors, with 
DECwindows by writing a DECwindows transport interface layer. 


9.4.1. Writing a Transport Interface 


For information about Weene a transport interface, see the VMS DECwindows 
Transport Manual. 


The transport interface image’s filename must have the following format where 
name is the unique transport name: 


DECW$TRANSPORT_name (for transports supplied by Digital) 
DECW_TRANSPORT_name (for customer-written transports) 
9.4.2 Installing the Transport Interface Image 


Install the image as a protected image in the SYS$SHARE directory (as defined 
by an executive mode logical name). Digital recommends that you install the 
image by adding the following line to SYS$MANAGER:SYSTARTUP_VMS.COM: 


$ INSTALL CREATE SYS$SHARE:DECW TRANSPORT name/OPEN/SHARED- 
/HEADER_RESIDENT/PROTECTED 


You can also include this command in a startup file that SYSTARTUP_ VMS calls. 


To use this transport with the DECwindows server, customize the server startup 
as described in Section 9.2. | 


9.5 Using the Example Transport 


DECwindows has an example transport interface based upon the Digital TCP/IP 
Services for OpenVMS layered product. It is similar to the DECwindows TCP/IP 
transport interface, except it includes its own source files and it uses a different 

port number (5000). You can run the example transport interface simultaneously 
with the TCP/IP transport interface. 


If you have installed Digital TCP/IP Services for OpenVMS software, you can 
install and use the example transport by doing the following: 


1: Copy the example transport to the SYS$SHARE directory as follows: 
$ COPY DECWSEXAMPLES : DECWSTRANSPORT EXAMPLE.EXE SYSS$SHARE: /PROT=W:RE 
2. Add the following line to SYSSMANAGER:SYSTARTUP_VMS.COM: 


$ INSTALL CREATE SYS$SHARE:DECWSTRANSPORT EXAMPLE /OPEN /SHARED- 
/HEADER RESIDENT /PROTECTED 
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Customize the private server startup as described in Section 9.2 for TCP/IP, 
except use the transport name “EXAMPLE”. For example, you could add the 
following line: 


$ DECWSSERVER TRANSPORTS == "DECNET, LOCAL, TCPIP, EXAMPLE" 
Reboot the workstation, or restart DECwindows. 


Customize TCP/IP security as described in the Using DECwindows Motif 
for OpenVMS manual, but use the transport name “EXAMPLE” instead of 
“LOPIP*, 


Create a DECterm window on the workstation and enter the following 
command: 


$ SET DISPLAY /CREATE /NODE=your node /TRANSPORT=EXAMPLE 
Substitute the node name of your workstation for your_node. 


Remember that the same transport must be running on both the client and 
server. It is not necessary, however, for the client and the server to be on the 
same system. 


Run any DECwindows application from the DECterm window. It will now use 
the example transport to display graphics on your workstation screen. For 
| example, you would enter the following command to run the clock: 


9 RUN SYSSSYSTEM:DECWSCLOCK 
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Using VMSTAILOR and DECWS$TAILOR 


This chapter describes how to add or remove optional OpenVMS VAX files 

and DECwindows support files from your system disk using VMSTAILOR and 
DECWS$TAILOR. You will need your OpenVMS VAX software media kit to tailor 
on files. Any site-specific customization that has been done to a class will be lost 
when that class is tailored off. 


10.1 Using VMSTAILOR 


To add or remove unwanted OpenVMS VAX files from the system disk, use 
VMSTAILOR. For example, if you are not running DECnet for OpenVMS, and 
you do not need the network support files, you can remove those files using 
VMSTAILOR. If you later decide you want to run DECnet for OpenVMS, you 
can add the necessary files at any time using VMSTAILOR and your OpenVMS 
VAX distribution media. (Note that you cannot tailor files on or off an alternate 
device.) 


10.1.1 How VMSTAILOR Works 
VMSTAILOR has three phases: 


1. VMSTAILOR asks if you want to tailor your system by adding files (tailor on) 
or by deleting files (tailor off). 


2. If you choose to tailor files on, VMSTAILOR lists each class of OpenVMS VAX 
files and asks if you want to include them on the system disk. If you choose 
to tailor files off, VMSTAILOR lists each class of files and asks if you want to 
delete them from the system disk. 


3. VMSTAILOR adds or deletes the files you indicated from the system disk. 
If you are tailoring files on, you must load your OpenVMS VAX distribution 
media in a drive available to the system. If your distribution media consists 
of more than one piece, put the first piece of the media into the drive. 


The following is a list of classes and subclasses of OpenVMS VAX files that can 
be added or deleted by using VMSTAILOR. For a complete list of OpenVMS VAX 
files and their functions, see the OpenVMS System Manager’s Manual: Tuning, 
Monitoring, and Complex Systems. _ 


e Network Support 


Incoming Remote File Access files 
Incoming Remote Terminal files 
Network Test files 

Remote Task Loading 


e Programming Support 


Debugger utility (DEBUG) 
Image Dump utility (ANALYZE/PROCESS_DUMP) 
RMS Analyze and FDL Editor utilities (ANALYZE/RMS, ANALYZE/FDL) 
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Message utility (MESSAGE) 
Object and Shareable Image libraries 
~ MACRO libraries 
MACRO assembler | 
SDL intermediary form of STARLET.MLB 
Fortran required files 
VAX C object libraries — 


® Op VMS RMS |.I 1 rnaling Hilas 


e System Programming Support 


Files—11 ODS-1,ISO 9660, High Sierra ACPs 

Monitor utility 

Delta/XDelta debugger 

System Dump Analyzer utility (ANALYZE/SYSTEM, ANALYZE/CRASH) 
System Symbol Table file (SYS.STB) 

Miscellaneous Symbol Table files 


e Secure User’s Environment 


File Access Control List utilities 
Print and Batch Queue utilities 
Input Queue Symbiont (Card Reader) 
Accounting Log Report Generator utility 
DECdtm 
¢ Utilities 
Mail utility 
DUMP utility 
RUNOFF utility 
Phone utility | 
OpenVMS Help library 
OpenVMS System Messages Help Library 
Foreign Terminal Support 
LAT-11 terminal server (via Ethernet) 
Standalone BACKUP 
Error Log Report Generator utility (ANALYZE/ERROR) 
DECTPU utility 
Terminal Fallback facility 
TECO editor . 
EDT documentation 
National Character Set utility (NCS) 


e VMS Workstation Support (VWS) 
Workstation device support 

e BLISS require files 

e Miscellaneous Files 


System map 
LPA-11 support 


e User Environment Test Package 


e Example Files — 
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10.1.2 Removing OpenVMS VAX Files 
To remove unwanted files using VMSTAILOR, perform the following steps: 


1. 
2. 


Log in to the SYSTEM account. 
Enter the following command and press the Return key: 
$ RUN SYSSUPDATE: VMSTAILOR 


VMSTAILOR displays a description of the VMSTAILOR program and displays 
the following message: 


Do you want to tailor files "ON" or "OFF"? 


Enter OFF to remove unwanted files and press the Return key. 


The VMSTAILOR program lists each group, or class, of files and its size in 
blocks. Files are grouped according to their function. For example, all the 
files required for network support are in one class. A file class is made up of 
many smaller groups called subclasses. You can eliminate an entire class of 
files, or you can eliminate one or more of its subclasses. For example: 


CLASS - Network support 
Size of entire class (with subclasses): 1499 
Size of common files required for any subclass: 1249 
Do you wish to select the entire class (default = NO)? 


Decide which file classes or subclasses you do not need to support your 
system. The VMSTAILOR program displays step-by-step instructions. Follow 
these instructions to specify which classes or subclasses of files you want to 
remove. 


VMSTAILOR deletes the files you selected and displays the names of 
those files. After it finishes, AUTOGEN runs automatically to make the 
adjustments that are necessary after system files are deleted. AUTOGEN 
also reboots the system. 


Caution 


To cancel VMSTAILOR during the first and second phases, press CtrIl/C, 
Ctrl/Y, or Ctrl/Z. Canceling VMSTAILOR during the third phase can cause 
a partially tailored disk. 


For a description of each phase, see Section 10.1.1. 


10.1.3 Adding OpenVMS VAX Files 


To add optional OpenVMS VAX files that you previously removed, or that you 
chose not to install during the OpenVMS VAX installation procedure, do the 
following: 


1. 
2. 


Log in to the SYSTEM account. 


Load your distribution media in a drive available to the system. For example, 
if your distribution media is on a TK50 tape cartridge, load the first tape 
cartridge in a TK50 drive that is available to the system. Make sure the drive 
is on line and ready. 
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If you are adding files from a compact disc on an InfoServer, first determine 
whether the SYSGEN parameter SCSNODE is defined on your system 

(see Section 5.6) or start the DECnet software, and then refer to step 2 of 
Section 7.3. 


3. Enter the following sian and press the Return key: 


$ RUN SYSSUPDATE: VMSTAILOR 


awa} 


VMSTAILOR displays a description of the VMSTAILOR program and dispiays 
the following message: 


Do you want to tailor files "ON" or "OFF"? 


4. Enter ON to add files and press the Return key. 


The VMSTAILOR program lists each group, or class, of files and its size in 
blocks. Files are grouped according to their function. For example, all the 
files required for network support are in one class. A file class is made up of 
many smaller groups called subclasses. You can add an entire class of files, or 
you can add one or more of its subclasses. For example: 


CLASS - Network support 
Size of entire class (with subclasses): 1499 
Size of common files required for any subclass: 1249 
Do you wish to select the entire class (default = NO)? 


5. Decide which file classes or subclasses you need to add. VMSTAILOR displays 
step-by-step instructions. Follow these instructions to specify which classes or 
subclasses of files you want to add. 


6. VMSTAILOR adds the files you specified and displays the names of the files. 
After the files have been added, AUTOGEN runs automatically to make the 
adjustments that are necessary after system files are added. AUTOGEN also 
reboots the system. 


Caution 


To cancel VMSTAILOR during the first and second phases, press Ctrl/C, 
Ctrl/Y, or Ctrl/Z. Canceling VMSTAILOR during the third phase can cause 
a partially tailored disk. 


For a description of each phase, see Section 10.1.1. 


After adding files to the system disk, apply any updates that affect them. 
OpenVMS VAX update procedures create a .TXT file that contains a 
description of patched files. This file usually has the following format: 
SYS$UPDATE:VMSUn06n. TXT. 


For example, suppose you do not need the OpenVMS Phone utility (PHONE) 

and you run VMSTAILOR to remove those files. Later, you decide you want to 
use Phone. Run VMSTAILOR to return the Phone files to the system disk; then, 
apply any OpenVMS VAX update that has occurred since Version 7.1 that affected 
the Phone utility. 
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10.1.4 Sample Session 


Example 10-1 shows how to add all Network Support files and selected 
Programming Support files to a system disk. 


Example 10-1 Sample VMSTAILOR Session 


$ RUN SYSSUPDATE: VMSTAILOR 


Do you want to tailor files "ON" or "OFF"? ON 


TAILOR-ON 


You will now be prompted with a list of the classes and subclasses 
of OpenVMS VAX files that are optional. The size of each class and subclass is included 


in the list. This will 


help you decide whether or not you want to add 


a class or subclass to your system. 


Under some classes, there is a set of common files that is required in order 
for any subclasses to work. These files are added when you ask 
for either the entire class or any of its subclasses. 


Total size of the system disk is 2376153 blocks. 
Total space used on the system disk is 2241252 blocks. 
Total space left on the system disk is 134901 blocks. 


CLASS - Network support 


Size of entire class (with subclasses): 1499 
Size of common files required for any subclass: 1249 
Do you wish to select the entire class (default = NO)? YES 


CLASS - Programming Support 
Size of entire class (with subclasses): 14706 
Size of common files required for any subclass: 0 
Do you wish to select the entire class (default = NO)? 
Do you wish to select any of its subclasses (default = NO)? )YES 
Select the subclasses that you wish to provide: 


SUBCLASS - 
SUBCLASS - 
SUBCLASS - 


Debugger utility (DEBUG) (4690 blocks) [NO]: YES 
Image Dump utility (ANALYZE/PROCESS DUMP) (48 blocks) [NO]: YES 
RMS Analyze and FDL Editor utilities (ANALYZE/RMS, ANALYZE/FDL)- 


(374 blocks) [NO]:YES 


SUBCLASS - 
SUBCLASS - 
SUBCLASS - 
SUBCLASS - 
SUBCLASS - 
SUBCLASS - 
SUBCLASS - 


Message utility (MESSAGE) (49 blocks) [NO]: 

Object and Shareable Image libraries (4311 blocks) [NO]: YES 
Macro libraries (2293 blocks) [NO]: 

Macro assembler (457 blocks) [NO]: 

SDL intermediary form of STARLET.MLB (1957 blocks) [NO]: 
FORTRAN require files (51 blocks) [NO]: 

VAX-C object libraries (471 blocks) [NO]: 


CLASS - RMS journaling files 
Size of entire class (with subclasses): 155 


No subclasses 


in this tailor class. 


Do you wish to select the entire class (default = NO)? 


CLASS - System programming Support 
Size of entire class (with subclasses): 2286 
Size of common files required for any subclass: 93 
Do you wish to select the entire class (default = NO)? 
Do you wish to select any of its subclasses (default = NO)? 


(continued on next page) 
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Example 10-1 (Cont.) Sample VMSTAILOR Session 


CLASS - Secure User’s Environment 
Size of entire class (with subclasses): 919 
Size of common files required for any subclass: 0 
Do you wish to select the entire class (default = NO)? 


Do you wish to select any of its subclasses (default = NO)? 


Files have been selected 

Do you wish to add all of the options selected? YES 
Creating temporary command file, please wait... 

* Enter device containing OpenVMS distribution media: mua0: 


10.2 Using DECW$TAILOR 


You can use DECW$TAILOR to add or remove some or all DECwindows X11 
display server, base support, and fonts files from the system disk. For example, 
if you are not planning to use the DECwindows PEX (PHIGS Extensions 

to X) support, you can remove those files. Later, if you decide you want 
DECwindows programming support, you can add the files to the system disk 
using DECW$TAILOR and your DECwindows distribution media. You cannot 
tailor files on or off an alternate device. | 


Note 


To add or remove VMS DECwindows Motif files, refer to the DECwindows 
Motif Version 1.2-3 for OpenVMS Installation Guide. DECW$TAILOR 
will only tailor on or off those DECwindows display server, base support, 
and font files, with the exception of the required files, supplied on the 
OpenVMS VAX kit. 


10.2.1 How DECWSTAILOR Works 
DECW$TAILOR has three phases: 


¢ DECWS$TAILOR asks if you want to tailor your system by adding files (tailor 
on) or by deleting files (tailor off). | 


e If you choose to tailor files on, DECW$TAILOR lists each class of 
DECwindows files and asks if you want to include them on the system 
disk. If you choose to tailor files off, DECW$TAILOR lists each class of 
DECwindows files and asks if you want to delete them from the system disk. 


e¢ DECWS$TAILOR adds or deletes the files you indicated from the system disk. 
If you are tailoring files on, you must load your DECwindows distribution 
media in a drive that is available to the system. For example, if your 
OpenVMS VAX distribution kit is on a TK50 tape cartridge, load the second 
tape cartridge, which contains the DECwindows support files, into a TK50 
drive that is available to the system. 
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10.2.2 DECwindows Files You Can Tailor 


The following is a list of classes and subclasses of DECwindows files that you can 
add or delete using DECW$TAILOR. For a list of DECwindows files and their 
functions, see Appendix E. 


DECwindows base support files—If you plan to install the separate 
DECwindows Motif for OpenVMS VAX layered product, you must add 
the base support files. 


DECwindows workstation support files—If you are installing DECwindows 
support on a workstation or in a cluster that includes workstations or if you 
intend to install the DECwindows Motif for OpenVMS VAX layered product, 
you need the workstation support files. Otherwise, you do not need them. 


Note 
If you tailor device support files ON or OFF, the system reboots. 


100 dots/inch video font files—By default, some workstation monitors (for 
example, a VR150, VR160, or VR295) display 100 dots/inch, which gives you 
a more readable display when you run DECwindows applications. If your 
workstation monitor cannot display 100 dots/inch fonts (for example, a VR260 
or VR290), you can save disk space by not selecting this option. For more 
information about the capabilities of your particular monitor, see the owner’s 
guide for your monitor. 


75 dots/inch video font files—If your workstation monitor cannot display 75 
dots/inch, you can save disk space by not selecting this option. For more 
information about the capabilities of your particular monitor, see the owner’s 
guide for your monitor. | 


10.2.3 Removing DECwindows Files 


To remove DECwindows files from the system disk, do the following: 


1. Login to the SYSTEM account. 


2. Type the following command, and press Return: 


$ RUN SYSSUPDATE: DECWSTAILOR 


DECW$TAILOR displays information about the DECW$TAILOR program 
and displays the following message: 


Do you want to tailor files "ON" or "OFF"? 


Type OFF to remove unwanted files, and press Return. 


The DECW$TAILOR program lists each group, or class, of files and its size 
in blocks. Files are grouped according to their function. For example, all the 
files required for DECwindows device support are in one class. A file class is 
made up of many small subclasses. You can eliminate an entire class of files, 
or you can eliminate one or more of its subclasses. For example: 
CLASS - DECwindows workstation support files 

Size of entire class (with subclasses): 14301 


Size of common files required for any subclass: 8937 
Do you wish to select the entire class (default = NO)? 
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4. Decide which file classes or subclasses you need to add. DECW$TAILOR 
displays step-by-step instructions. Follow these instructions to specify which 
of the classes or subclasses you want to remove. 


5. DECW$TAILOR deletes the files you selected and displays the names of those 
files. If you deleted device support files, the system automatically shuts down 
and reboots. 


Caution 


To cancel DECW$TAILOR during the first and second phases, press 
Ctrl/C, Ctrl/Y, or Ctrl/Z. Canceling DECW$TAILOR during the third 
phase can cause a partially tailored disk. 


For a description of each phase, see Section 10.2.1. 


10.2.4 Adding DECwindows Files 


To install DECwindows device support and font files after the OpenVMS VAX 
installation or to add optional DECwindows files that you previously chose not to 
install or that you removed, do the following: 


1. Login to the SYSTEM account. 


2. Load the OpenVMS VAX distribution media containing the DECwindows save 
sets in a drive available to your system. For example, if your distribution 
media is a TK50 tape cartridge, load the second tape cartridge into a TK50 
drive that is available to the system. Make sure the drive is on line and 
ready. 


If you are adding files oi a eansace disc on an InfoServer, first determine 
whether the SYSGEN parameter SCSNODE is defined on your system — 

(see Section 5.6) or start the DECnet software, and then refer to step 2 of 
Section 7.3 in Chapter 7. 


3. Enter the following command, and press Return: 
$ RUN SYSSUPDATE: DECWSTAILOR 
DECWS$TAILOR displays information about the DECW$TAILOR program, 
and displays the following message: 


Do you want to tailor files "ON" or "OFF"? 


4. Type ON to add files, and press Return. 


The DECW$TAILOR program lists each group, or class, of files and its size 
in blocks. Files are grouped according to their function. For example, all the 
files required for DECwindows device support are in one class. A file class is 
made up of many small subclasses. You can add an entire class of files, or you 
can add one or more of its subclasses. For example: 
CLASS - DECwindows workstation support files 

Size of entire class (with subclasses): 14301 


Size of common files required for any subclasses: 8937 
Do you wish to select the entire class (default = NO)? 
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5. Decide which file classes or subclasses you do not need to support your 
system. The DECW$TAILOR program displays step-by-step instructions. 
Follow these instructions to specify which of the classes or subclasses you 
want to add. 


6. DECWS$TAILOR installs the files you selected and displays the names of 
those files. If you added device support files, the system automatically shuts 
down and reboots. 


Caution 


To cancel DECW$TAILOR during the first and second phases, press 
Ctrl/C, Ctrl/Y, or Ctrl/Z. Canceling DECW$TAILOR during the third 
phase can cause a partially tailored disk. For a description of each phase, 
see Section 10.2.1. 


After adding files to the system disk, apply any updates that affect them. For 
example, suppose you delete the Version 7.1 DECwindows 100 dots/inch video 
font files. Later on, you are able to use the 100 dots/inch fonts, so you run 
DECWS$TAILOR to return the files to the system disk. You must then apply any 
OpenVMS VAX update that has occurred since Version 7.1 that affected the 100 
dots/inch video font files. OpenVMS VAX update procedures create a .TXT file 
that contains a description of modified files. This file is usually named with the 
following format: SYS$UPDATE:VMSUn05n.TXT!. 


10.2.5 Sample Session 


Example 10-2 illustrates how to add the files for DECwindows 100 dots/inch font 
files. 


Example 10-2 Sample DECWS$TAILOR Session 


$ RUN SYSSUPDATE: DECWSTAILOR 


Do you want to tailor files "ON" or "OFF"? ON 
TAILOR-ON 


You will now be prompted with a list of the classes and subclasses 

of DECwindows files that are optional. The size of each class and subclass is 
included in the list. This will help you decide whether or not you want to add 
a class or subclass to your system. 


Under some classes, there is a set of common files that is required in order 
for any subclasses to work. These files are added when you ask 
for either the entire class or any of its subclasses. 7 


Total size of the system disk is 2376153 blocks. 
Total space used on the system disk is 1728072 blocks. 
Total space left on the system disk is 648081 blocks. 


CLASS - DECwindows base support files 
Size of entire class (with subclasses): 3363 


(continued on next page) 


1 Examine this file to determine if the update patched the 100 dots/inch font files 
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Example 10-2 (Cont.) Sample DECWSTAILOR Session 


No subclasses in this tailor class. | | 
Do you wish to select the entire class (default = NO)? 


CLASS - DECwindows workstation support files 
Size of entire class (with subclasses): 12376 
Size of common files required for any subclass: 8916 
Do you wish to select the entire class (default = NO)? NO 
Do you wish to select any of its subclasses (default = NO)? 


CLASS - 75 dots per inch video font files 
Size of entire class (with subclasses): 4537 


No subclasses in this tailor class. 
Do you wish to select the entire class (default = NO)? 


CLASS - 100 dots per inch video font files 
Size of entire class (with subclasses): 3693 
No subclasses in this tailor class. 
Do you wish to select the entire class (default 


NO)? YES 


Files have been selected 

Do you wish to add all of the options selected? YES 

Creating temporary command file, please wait... 

* Enter device containing DECwindows distribution media: MUAO0: 
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Multiversion VAX Upgrade Process 


This appendix provides you with an express method and easy to follow set of 
directions to apply multiple OpenVMS VAX version upgrades to your current 
system. 

Note 


By following these directions, the time that you spend on upgrading 
your VAX computer from Version 5.5-2 to Version 7.1 can be significantly 
reduced. 


A.1 Determine Your Path 


Your first step is to determine which upgrade path you need to perform Table A-1 
lists the recommended upgrade paths to reach OpenVMS VAX Version 7.1. 


Table A-1 OpenVMS VAX Upgrade Version Matrix 


Current Version intermediate Version(s) Final Version 
5.5-2 6.1 7.1 
6.0 6.1 or 6.2 7.1 
6.1 : 7.1 
6.2 : 7.1 
7.0 : Tod 


1No intermediate version needed. 


A.2 Multiversion Upgrade Procedure 


This procedure refers to an intermediate upgrade and final upgrade. An 
intermediate upgrade is defined as a version of the operating system that you 
need to install to reach your final version. . 


The final upgrade is the version of the operating system that you want to be 
running on your system at the end of this process. 
__ Important - 


You should not plan to stay at the intermediate version. If you do need 
to upgrade to and run the intermediate version, please use the normal 
upgrade procedure located in the specific version installation manual. 
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A.2.1 Before You Begin the Upgrade 


Before you begin the multiversion upgrade, you need to perform the following 
steps: | 7 


1. Locate the OpenVMS VAX software kits for the versions that you need. 


2. Review the layered products on your system to determine the minimum 


supported version of each layered product to be installed on your final 
operating system version. 


ee tet ele i te Ne ee 


e Determine which layered products you want to run on your system. See 
the web page at the following URL: 


http: //www.service.digital.com/openvms 


e For information about specific layered products, see Section A.3. 


A.2.2 Intermediate Upgrade 


Follow these steps to perform an intermediate upgrade of your OpenVMS VAX 
operating system. 


1. Review your mixed-cluster version environment. Digital recommends that 
you upgrade all of your systems to the same version prior to performing a. 
multiversion upgrade. | | 


2. Review the firmware running on your system. For information about specific 
layered products, see Section A.3. | 


3. Review the version-specific documentation. Digital recommends that you read 
the New Features, Release Notes, Installation Guide manuals and Software 
Product Description available in your software kit. 


Review the preupgrade checklist located in the Installation Guide. 
Perform the upgrade. | | 


Important __ 


For the intermediate upgrade, install only the base operating system. 
Do not install any options. By installing only the base operating system, 
the time that you spend on upgrading your VAX computer during this 
intermediate upgrade can be reduced by 40 percent. 


6. Perform the postupgrade checklist located in the Installation Guide. 


If you are performing multiple intermediate upgrades, repeat steps 3-7 as. 
necessary. 


8. You have completed the intermediate phase of the multiversion upgrade 
procedure. Proceed to Section A.2.3 to apply the final upgrade phase of this 
procedure . 
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A.2.3 Final Upgrade 


Follow these steps to perform the final upgrade of your OpenVMS VAX operating 
system. 


1. Review the version-specific documentation. Digital recommends that you read 
the New Features, Release Notes, Installation Guide manuals and Software 
Product Description available in your software kit. 


Perform the preupgrade checklist located in the Installation Guide. 


3. Perform the complete upgrade and select the optional files that you need for 
your final version. 


Perform the postupgrade checklist located in the Installation Guide. 


Upgrade the layered products on your system based on your review of layered 
products in Section A.2.1. See the web page at the following URL: 


http://www.service.digital.com/openvms 


A.3 Specific Layered Product and Firmware Information 


This section provides specific information about the following layered products 
and firmware: 


e BASEstar 
e Debugger 


A.3.1 Layered Products 


This section contains information about layered products. 


BASEstar Classic Domain 

A BASEstar Classic domain that consists of BASEstar Classic for OpenVMS VAX 
Versions 3.2 and 3.3 is fully supported on OpenVMS Version 7.1, as long as you 
have obtained the kits through normal support channels. 


However, on Alpha systems you need to be running BASEstar Classic Version 3.4. 
This means that any BASEstar Classic domain consisting of both VAX and Alpha 
systems can only have the VAX systems upgraded to OpenVMS Version 7.1 at 
this time. 


Debugger Graphical User Interface (GUI) 


In order to run the Debugger Graphical User Interface (GUI) on OpenVMS 
Version 7.1, you must be running the DECwindows Motif for OpenVMS layered 
product. See Section 1.2.2 for information about DECwindows Motif. 
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License Management Notes 


B.1 Overview 


This appendix contains supplemental information to the license instructions 

given in the installation and upgrade procedures and in the OpenVMS License 
Management Utility Manual. Although most of the information in this appendix 
pertains to managing OpenVMS and System Integrated Product (SIP) licenses, 
some of the information pertains to managing layered product licenses. 


This appendix covers the following information: 

e Registering your licenses 

e Using the License Unit Requirement Table (LURT) 
e License Management Facility (LMF) notes 

e Volume Shadowing for OpenVMS license 

e Other System Integrated Product (SIP) licenses 


B.2 Registering Your Licenses 


This section provides an overview of the license registration procedure. 


B.2.1 When to Register 


After you install the OpenVMS VAX operating system, you must register an 
OpenVMS VAX license. An OpenVMS VAX license lets you use the operating 
system. You must also register the licenses for any of the following SIPs you have 
purchased: 


e VAXclusters 

e DECnet—Plus 

e OpenVMS RMS Journaling 

e Volume Shadowing for OpenVMS 


After you upgrade the OpenVMS VAX operating system, in most cases there is no 
need to reregister licenses for the operating system or for SIPs. 


In addition to the OpenVMS VAX operating system and the SIPs, many layered 
products—including DECwindows Motif for OpenVMS VAX—that run on 
OpenVMS VAX Version 7.1 also require license registration. See the OpenVMS 
License Management Utility Manual for a full explanation of license registration. 
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B.2.2 How to Register 


To register a license, you need to obtain a Product Authorization Key (PAK). A 
typical PAK is a piece of paper provided by Digital Equipment Corporation that 
contains the appropriate information to authorize access to software on a VAX 
computer or in a VAXcluster environment. You can obtain a PAK from a Digital 
representative the same way as you obtain software. 


See Table B—1 for a complete list of the versions of the OpenVMS VAX operating 
system and the VAX computers that were first supported by these versions. 


Table B—-1 First VMS or OpenVMS Version That Supports VAX Computers 


VMS Version First Computer Support 

Version 5.0 VAX 6000 Model 2xx, VAX 8820-8840 

Version 5.0-2A MicroVAX 3300/3400 

Version 5.1 VAX 6000 Model 3xx, MicroVAX 3800/3900 

Version 5.1—B VAXstation 3100, Model 30/40 

Version 5.1-1 VAXstation 3520/3540 

Version 5.2 VAX 6000 Model 4xx, MicroVAX 3100 

Version 5.2—1 VAXstation 3100, Model 38/48 

Version 5.3 No CPUs introduced 

Version 5.3—1 No CPUs introduced 

Version 5.3-2 VAX 4000 Model 300 

Version 5.4 | VAXstation 3100 Model 76, VAX 9000, VAX 6000 Model 5xx, 
| VAXft 310 

Version 5.4—1 No CPUs introduced 

Version 5.4—2 | VAX 4000 Model 200 

Version 5.4—3 VAXft Models 410, 610, 612 

Version 5.5 VAXstation 4000 VLC, MicroVAX 3100 Models 30, 40, and 80, 


VAX 6000 Model 600, VAX 4000 Model 500, VAXstation 4000 
Model 60, and VAXft Model 110 


Version 5.5—2 VAX 4000 Model 100, VAXstation 4000 Models 90 and 100, 
MicroVAX 3100 Model 90, VAX 4000 Model 400, VAX 4000 
Model 600, VAX 7000 Model 600, and VAX 10000 Model 600 


Version 5.5—-2H4 VAX 4000 Models 100A, 500A, 600A, and 700A | 
Version 5.5-2HF VAXft Model 810 
OpenVMS Version First Computer Support 
Version 6.0 VAX 7000 Models 650 and 660, 
VAX 10000 Models 600 and 650 
Version 6.1 VAX 7000 Model 7xx 
Version 6.2 VAX 4000 Model 106A, MicroVAX 3500 Model 95A, MicroVAX 


3100 Model 96, VAXstation 4000 Model 96 
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B.3 Using the License Unit Requirement Table (LURT) 


Many PAKs contain a table name in the availability or activity fields. This name 
refers to a column in the License Unit Requirement Table (LURT). (For more 
information about using the LURT, see the eee License Management Utility 
Manual.) 


Table B—2 has seven lettered columns (A, B, C, D, E, F, and I; G and H are 
reserved by Digital and therefore are not listed). The numbers listed in these 
columns indicate the number of license units required for each processor listed 

in the System Marketing Model column. For example, if your PAK specifies 
availability = F, you would require 100 license units to load the license on a VAX— 
11/780 computer, or 4800 license units to load the license on a VAX 9000-430 
computer. 


Note that some PAKs specify MOD_UNITS in the options field. The MOD_UNITS 
option allows the system manager to use the DCL command LICENSE MODIFY 
/UNITS to temporarily increase the size of the PAK. This permits a product 

to be used, in certain emergency situations, on a processor larger than the 
processor size specified in the license. Check your license terms and conditions 
before modifying license units. Reset the PAK size to its original size after the 
emergency situation is resolved. 


Table B—2 License Unit Requirement Table (LURT) 


License Types by Code 


OpenVMS SIP LP 
System Marketing Model A B Cc D E F l 
VAX-11/730 10 NA NA NA 230 50 50 
VAX 11/750 12 NA NA NA 230 100 100 
VAX 11/780, 785 13 NA NA NA 230 100 100 
VAX 6000-210, 6000-310 58 NA NA NA 230 300 300 
VAXft 110 60 NA NA NA 230 100 100 
VAXft 310, 410, 610, 810 58 NA NA NA 230 300 300 
VAX 6000-220, 6000-320, 69 NA NA NA 230 600 600 
6000-410 
VAX 6000-230, 6000-330, 81 NA NA NA 400 900 900 
6000-510 | | 
VAX 6000-240, 6000-340, 6000- 93 NA NA NA 400 1200 1200 


350, 6000-420, 7000-610, 


10000-610 


Key to License Type Codes and Values 


A—OpenVMS Capacity or OpenVMS Unlimited or Base 
B—OpenVMS Server 

C—OpenVMS Concurrent user 

D—OpenVMS Workstations 

E—System integrated products 

F—Layered products 

G—Reserved (not listed) 

H—OpenVMS reserved (not listed) 

I—Layered products 

NA—Not applicable 


(continued on next page) 
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Table B—2 (Cont.) License Unit Requirement Table (LURT) 
License Types by Code 


OpenVMS SIP 
System Marketing Model | A B Cc D | E 
VAX 6000-540, 6000-640 170 NA NA NA 600 
VAX 6000-550, 6000-650 195 NA NA NA 600 
VAX 6000-560, 6000-660 220 NA NA NA 600 
VAX 6000-610 81 NA NA NA 400 
VAX 8200, 8250 20 NA NA NA 230 
VAX 8300, 8350 25 NA NA NA 230 
VAX 8500 | 63 NA NA NA 230 
VAX 8530 65 NA NA NA 230 
VAX 8550, 8700, 8810 72 NA NA NA 400 
VAX 8600, 8650 28 NA NA NA 230 
VAX 8800, 8820 93 NA NA NA 400 
VAX 8830, 6000-360, 6000-430, 119 NA NA NA 600 
6000-520, 6000-620 
VAX 7000-620, 10000-620 145 NA NA NA 600 
VAX 6000-440, 6000-450, 143 NA NA NA 600 
6000-460, 6000-530 
VAX 7000-630, 10000-630, 167 NA NA NA 600 
VAX 7000-640, 10000-640, 197 NA NA NA 600 
VAX 6000-630, 143 NA NA NA 600 
9000-210, 9000-410 | 
VAX 9000-420 241 NA NA NA 800 
VAX 9000-430 330 NA NA NA 800 
VAX 9000-440 386 NA NA NA 800 
VAX 7000-710, 810 93 NA NA NA 230 
VAX 7000-720, 820 193 NA NA NA 230 
VAX 7000-730, 830 293 NA NA NA 230 
VAX 7000-740, 840 393 NA NA NA 230 
VAX 7000-750, 850 493 NA NA NA 230 
VAX 7000-760, 860 593 NA NA NA 230 
MicroVAX II 18 NA 100 NA 230 


Key to License Type Codes and Values 


A—OpenVMS Capacity or OpenVMS Unlimited or Base 
B—OpenVMS Server 

C—OpenVMS Concurrent user 

D—OpenVMS Workstations 

E—System integrated products 

F—Layered products 

G—Reserved (not listed) 

H—OpenVMS reserved (not listed) 

I—Layered products 

NA—Not applicable 


B-4 License Management Notes 


LP 


(continued on next page) 


License Management Notes 
B.3 Using the License Unit Requirement Table (LURT) 


Table B-2 (Cont.) License Unit Requirement Table (LURT) 
License Types by Code 


OpenVMS SIP LP 
System Marketing Model A B Cc D E F l 
MicroVAX 2000, 3100-10e, 3100- 18 NA 100 NA 230 20 20 
20e, 3100-30, 3100-40, 3100-80 
MicroVAX 3100-90, 3100-96, 60 NA 100 NA 230 20 20 
3100-96A 
MicroVAX 3500, 3600, 3800, 60 NA 100 NA 230 200 200 
3900, 4000-200 | 
MicroVAX 3300, 3400, 4000-100, 60 NA 100 NA 230 100 100 
4000-106A 
VAX 4000-100, 4000-106 60 NA 100 NA 230 100 100 
VAX 4000-300, 4000-400, 60 NA 100 NA 230 300 300 
4000-500A, 4000-600A, 
4000-700A, 4000-706A 
VAX 4000-500, 4000-600 60 NA 100 NA 400 900 900 
VAXstation II, I/GPX NA NA NA _ 100 50 10 10 
VAXstation 2000, 2000/GPX NA NA NA 100 50 10 10 
VAXstation 3100, 3200, 3500, NA NA NA 100 50 10 10 
3520, 3540, 4000-60, 4000 VLC, | 
4000-90, 4000-96 
VAXserver 2000 NA 52 NA NA 50 10 10 
‘VAXserver 3300, 3400, 3500, NA 100 NA NA 50 10 10 
3600, 3900, 4000-200, 4000-300 . 
VAXserver 6000-210, 6000-310 NA 1448 NA NA 230 200 200 
VAXserver 6000-220, 6000-320, NA 1737 NA NA 230 400 400 
6000-410, 6000-420 
VAXserver 6000-510 NA 600 NA NA 230 400 400 
VAXserver 6000-520 NA 890 NA NA 230 400 400 
VAXserver 9000-110, 9000-310 143 143 NA NA 600 900 900 
VAXserver 9000-320 241 241 NA NA 800 1200 1200 
VAXserver 9000-330 330 330 NA NA 800 1200 1200 
VAXserver 9000-340 386 386 NA NA 800 1200 1200 


Key to License Type Codes and Values 


A—OpenVMS Capacity or OpenVMS Unlimited or Base 
B—OpenVMS Server 

C—OpenVMS Concurrent user 

D—OpenVMS Workstations 

E—System integrated products 

F—Layered products 

G—Reserved (not listed) 

H—OpenVMS reserved (not listed) 

I—Layered products 

NA—Not applicable 
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B.4 License Management Facility Notes 


The following list is offered to help new users with some common concerns and 
questions regarding the License Management Facility (LMF). 


e If you do not have a valid OpenVMS VAX license that is registered and 


activated, the system displays a warning message as part of system startup 
and restricts system use to the operator’s console, OPAO. 


If a checksum error is displayed when you register a license, check all the 
fields of data that you entered, including the checksum itself. 


After your PAKs are registered, they are activated (loaded) automatically as | 
part of each system startup. 


If an OpenVMS VAX availability license is registered with insufficient license 
units for the specified VAX computer, the system displays a warning message 
at system startup but allows normal system use at the console level only. 


If an OpenVMS VAX activity license is registered with insufficient license 
units to meet your user requirements, the system displays the following 
message when the user (process) attempts to log in: 


SLICENSE-F-EXCEEDED, licensed product has exceeded current license limits 


A user can always log in to the operator’s console, OPAO, however. 


The default LICENSE database is located in the file 

SYS$COMMON: [SYSEXE]LMF$LICENSE.LDB. You can move the database, 
although Digital does not recommend doing so. If you move the database, 
you must either define the logical name LMF$LICENSE at the system level 
to point to the new database or use the /DATABASE=/filespec qualifier with — 
all LICENSE commands. To redirect LMF to another database location on 


- a more permanent basis, add the following line to the command procedure 


SYS$MANAGER:SYLOGICALS.COM: 
§ DEFINE/SYSTEM LMF$LICENSE device: [directory ]LMF$LICENSE.LDB 


If you specify a device other than SYS$SYSDEVICE, you must also mount 
the specified disk from the SYLOGICALS.COM command procedure. 


Each VAX VMS and OpenVMS VAX Base license is restricted to a single 
node for permanent PAKs. You must assign a System Communications 
Services (SCS) name to the license when you register with the 
VMSLICENSE.COM command procedure, or you must enter a LICENSE 
MODIFY/INCLUDE=node-name command after you register the license. 
Although you can successfully activate an unassigned OpenVMS VAX license 
on a standalone system, you cannot activate one in a VAXcluster environment. 


Note that the SCS node name is not necessarily the DECnet node name. 
SCSNODE is a system parameter; it can be a maximum of 6 alphabetic 
characters. | 


B.5 Volume Shadowing for OpenVMS License 
The following paragraphs describe Volume Shadowing for OpenVMS licenses. 
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B.5.1 When to Register 


After you install OpenVMS VAX Version 7.1, you must register your Volume 
Shadowing for OpenVMS license before you can use Volume Shadowing. If you 
upgraded to OpenVMS VAX Version 7.1, you do not need to reregister this license. 


B.5.2 Volume Shadowing Phase I and Phase Il 


In the past, volume shadowing has offered two modes of operation: phase I 

and phase II. The original implementation of shadowing, phase I, was HSC 
controller based. The newer implementation, phase II, is host based and provides 
performance superior to phase I. 


With the release of OpenVMS VAX Version 6.2, phase I Volume Shadowing is 
no longer available. Refer to the Volume Shadowing for OpenVMS manual for 
instructions about moving from phase I to phase II. 


B.5.3 Types of Licenses 
Two types of Volume Shadowing licenses are valid for OpenVMS VAX Version 7.1: 


e Capacity license—If you are using this type of license, you must have one 
license for each node in a cluster that is accessing shadowed data. 


e Per-disk license—If you are using this type of license, you must have one 
license for every disk contained in the shadow set. 
For information about OpenVMS VAX Version 7.1 changes to per-disk 
licensing for Volume Shadowing, refer to Section 1.2.1. 


See the Volume Shadowing for OpenVMS manual for more information about 
these two licenses. 


B.6 Other System Integrated Product Licenses 


After you install OpenVMS VAX Version 7.1, you must register licenses for any 
system integrated product. If you wpgraded to OpenVMS VAX Version 7.1, you do 
not need to reregister licenses for system integrated products. 
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Booting from [SYSF] During an Upgrade 


C.1 Booting Procedures 


You must boot from the [SYSF] root during phases 2, 3, and 4 of the upgrade 
procedure. Different VAX computers require that you use different booting 
procedures. This appendix describes how to boot the various VAX computers from 
ISYSF]. | 


Go to the section that describes your VAX computer and follow the instructions 
for booting from [SYSF]. If you need more information about booting, refer to the 
upgrade and installation supplement for your VAX computer. 


C.1.1 MicroVAX and VAXstation Computers 


The information in this section applies to the following VAX computers: 


VAXstation II, VAXstation II/GPX, and MicroVAX II 
VAXstation 2000 and MicroVAX 2000 

VAXstation 3100 and MicroVAX 3100 series 
VAXstation 3200 and 3500 

VAXstation 3520 and 3540 

VAXstation 4000 

VAXft 110, 310, 410, 610, and 612 

MicroVAX 3300, 3400, 3500, 3600, 3800, and 3900 


To boot from [SYSF], enter the BOOT command in the following format and press 
the Return key: 


>>> B/F0000000 device-name 


Substitute the device name of the system disk for device-name. 


C.1.2 VAX 8530, 8550, 8810 (8700), 8820-N (8800) Computers 
To boot from [SYSF], use the following procedure: 


1. Press Ctrl/P. Enter the following command at the console-mode prompt (>>>) 
and press the Return key: 


>>> HALT 


2. Enter the BOOT command at the console-mode prompt (>>>) in the following 
format: 


>>> B dddn /R5:F0000000 


Substitute BCI, BDA, or UDA for ddd. Substitute the unit number of the 
drive holding the system disk for n. 
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C.1.3 VAX 8820, 8830, and 8840 Computers 
To boot from [SYSF], use the following procedure: 
1. Enter the following command at the PS-OS-0> prompt and press Return: 
P§-0S-0> HALT/CPU=ALL 
2. Enter the BOOT command at the PS-CIO-0> prompt in the following format: 
PS-CIO-0> B dddn /R5=F0000000 
Substitute BCI or BDA for ddd. Substitute the unit number of the drive 
| holding the system disk for n. 
C.1.4 VAX—11/750, 8200, 8250, 8300, and 8350 Computers 


To boot from [SYSF, create a command procedure named SYFBOO.CMD before 
the upgrade is started. 


To create SYFBOO.CMD, use the following procedure: 


Note 


This procedure assumes that you have installed and booted the OpenVMS 
VAX operating system and are logged in to the SYSTEM account. 


1. Log in to the SYSTEM account. 
Make sure that the console media is in the console drive. 


To connect the console drive to the system, enter the following commands and 
press the Return key after each one: 
$ RUN SYSSSYSTEM: SYSGEN 


SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


4. Use the Exchange utility to copy the appropriate boot command procedure 
from the console media to your current directory on the system disk. If the 


system disk is on an HSC drive and you have created DEFBOO.CMD, enter 
the following command and press Return: 


$ EXCHANGE COPY CSA1:DEFBOO.CMD * 


On the VAX—11/750 computer, if the system disk is on a local drive, copy 
the boot command procedure that matches the drive that holds the system 
disk. For example, suppose the system disk is on an RPO6 drive and has a 
controller designation of A and a unit number of one. Enter the following 
command and press the Return key: 


$ EXCHANGE COPY CSA1:DA1BO0O.CMD * 


5. Edit the boot command procedure. Change the line that deposits a value 
in register 5 (R5). This line contains the comment /software boot flags. The 
value is a hexadecimal number with eight digits. For example: 


D/G R5 0 !software boot flags 


Change the left-most digit of the value to reflect the name of the root 
directory from which you want to boot. For example, to boot from the [SYSF] 
- root directory, change the line as follows: 


D/G/L R5 F0000000 !designated root is SYSF 
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6. Rename the boot command procedure to SYFBOO.CMD. For example, if the 
boot command procedure is DEFBOO.CMD, enter the following command and 
press the Return key: 


$ RENAME DEFBOO.CMD SYFBOO.CMD 


7. Use the Exchange utility to copy SYFBOO.CMD back to the console media. 
Enter the following command and press Return: 


$ EXCHANGE COPY SYFBOO.CMD CSA1:SYFBOO.CMD 


8. When the copy operation completes, enter the following command and press 
Return: 


$ DISMOUNT CSA1 


9. To secure the console media from unauthorized access, you must enter the 
following command and press Return: 


S$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA1 
To boot from [SYSF], use the following procedure: 


1. Make sure the console media is in the console drive. On the VAX—11/750 
computers, make sure the keylock switch is set to LOCAL. Set the BOOT 
DEVICE switch to position A. 


On the VAX 8200 computer, set the upper keylock switch to ENABLE and the 
lower keylock switch to HALT. 


Press Ctrl/P. 


On the VAX-11/750 computer, enter the following command and press the 
Return key: 


>>> B/800 DDAO 


On the VAX 8200 computer, enter the following command at the console-mode 
prompt (>>>) and press Return: 


>>> B/R5:800 CSAl1 
4. At the BOOT58> prompt, enter the following command: 
BOOT58> @SYFBOO.CMD 


C.1.5 VAX-—11/730, 11/780, 11/785, 8600, and 8650 Computers 


To boot from [SYSF], create a command procedure named SYFBOO.CMD (for 
VAX—11/730, 11/780, and 11/785 computers) or SYFBOO.COM (for VAX 8600 and 
8650 computers) before the upgrade is started. | 


To create SYFBOO.CMD or SYFBOO.COM, use the following procedure: 


Note 


This procedure assumes that you have installed and booted the OpenVMS 
VAX operating system and are logged in to the SYSTEM account. 


Log in to the SYSTEM account. 


2. Make sure that the console media is in the console drive. On the VAX 8600 
computer, make sure the TERMINAL CONTROL switch is set to LOCAL. 
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3. To connect the console drive, enter the following commands and press the 
Return key after each one: 


$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


4. Use the Exchange utility to copy DEFBOO.CMD (for 
VAX—11/730, 11/780, and 11/785 computers) or DEFBOO.COM (for VAX 8600 


and 8650 computers) from the console media to your eurrent directory on 


Se 


the system disk. On the VAX—11/780, 11/785, and 8600 computers, enter a 
command similar to the following and press Return: 


$ EXCHANGE COPY CSA1:DEFBOO.CMD * 


On the VAX—11/730 computer, enter the following command and press the 
Return key: 


$ EXCHANGE COPY CSA2:DEFBOO.CMD * 


5. Edit DEFBOO.CMD or DEFBOO.COM. Change the line that deposits a value 
in register 5 (R5). On the VAX-11/730, 11/780, and 11/785 computers, this 
line contains the comment /software boot flags. On the VAX 8600, this line 
contains the comment /Use Rd for optional boot control flags [SYSB./. The 
value is a hexadecimal number with eight bits. For example: 


DEPOSIT R5 10000000 !software boot flags 


Change the left-most digit of the value to reflect the name of the root directory 
from which you want to boot. For example, to boot from [SYSF], mene the 
line as follows: 


DEPOSIT R5 F0000000 !software boot flags 


6. Rename DEFBOO.CMD to SYFBOO.CMD (or DEFBOO.COM to 
SYFBOO.COM), as follows: 


$ RENAME DEFBOO.CMD SYFBOO.CMD 


7. Use the Exchange utility to copy SYFBOO.CMD or SYFBOO.COM to the 
console media. On the VAX—11/780, 11/785, and 8600 computers, enter a 
command similar to the following: 


$ EXCHANGE COPY SYFBOO.CMD CSA1:SYFBOO.CMD 


On the VAX—11/730 computer, enter the following command and press the 
Return key: 


$ EXCHANGE COPY SYFBOO.CMD CSA2:SYFBOO.CMD 


8. When you are finished, enter a command similar to the following and press 
Return: 


$ DISMOUNT CSA1 


9. To secure the console media from unauthorized access, you must enter a 
| command similar to the following and press Return: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA1 
To boot from [SYSF] during an upgrade, use the following procedure: 


1. Make sure the console media is in the console drive. On the VAX—11/730, 
11/780, and 11/785 computers, make sure the keylock switch is set to LOCAL. 
On the VAX 8600, make sure the TERMINAL CONTROL switch is set to 
LOCAL. 
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Press Ctrl/P. On the VAX-11/780, 11/785, and 8600 computers, enter the 
HALT command at the console-mode prompt (>>>) and press the Return key: 


>>> HALT 


Use SYFBOO.CMD to boot from [SYSF]. Enter the following command and 
press Return: 


>>> B SYF 


C.1.6 VAX 6000 Series 
To boot from [SYSF], use the following procedure: 


1. 


If you have a CIBCA-A adapter and are booting over the CI, insert the console 
tape cartridge in the console drive. 


Press Ctrl/P to put the system in console mode. 

Enter the BOOT command in the following format: 

>>> BOOT /R5:F0000000 /XMI:a /BI:b [/R3:c] [/NODE:d] DUu 
where: 

e ais the XMI node number of the system disk. 

e 6is the VAXBI node number of the system disk. 


¢ c pertains to volume shadowing. This qualifier is not required unless 
you are using volume shadowing. For more information, see the Volume 
Shadowing for OpenVMS manual. 


e dis the HSC node number of the node being accessed. The /NODE 
qualifier is not necessary if you are booting from a local disk. The HSC 
node number is in hexadecimal. You can deposit a maximum of two HSC 
node numbers (if two HSCs are available). 


e wis the unit number of the drive holding the system disk. 


For example, suppose you want to boot from [SYSF] on an HSC disk with a 
unit number of one and your system has the following configuration: 


e The disk is connected to the VAXBI at node 2. 


e The VAXBI you are using is connected to the XMI at 
node 3. 


e The disk is available to two HSCs, node numbers OE 
and 02. 


Enter the following command and press the Return key: 


>>> BOOT/R5:F0000000/XMI:3/BI:2/NODE:0E02 DU1 
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C.1.7 VAX 9000 Series 


The upgrade procedure automatically updates DEFBOO.CMD to boot from | 
[SYSF]. If you want to boot a VAX 9000 computer manually from [SYSF] however, 
you must set up DEFBOO.CMD to boot from the system disk and perform the 
following procedure: 


1. Press Ctrl/P to obtain the console prompt. 


e 
2. Enter the following BOOT commands: 


>>> 1/K 

>>> BOOT/NOSTART 

>>> DEPOSIT R5 F0000000 
>>> CONTINUE 


3. If you set up DEFBOO.CMD properly, the system will boot from the SYSF 
directory on the system disk and continue with the upgrade procedure. 


If the system does not boot, enter the SHOW CONFIGURATION console 
command and verify that DEFBOO.CMD contains the correct information for 
your configuration. For more information, see the OpenVMS VAX Upgrade 
and Installation Supplement: VAX 9000 Series. 
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OpenVMS VAX Save Set Subclasses 


This appendix lists the file subclasses contained in the following save sets: 
e VMS070.C—Library save set 

e VMS070.D—Optional save set 

e VMS070.E—Help Message save set 

e VMS070.F—OpenVMS Management Station save set 


D.1 Save Set C Subclasses 


The following files are contained in the Library save set: 
e Network support 


Incoming Remote File Access files 
Incoming Remote Terminal files 
Network Test files — 

Remote Task Loading 


e Programming Support 


Debugger utility (DEBUG) 

Image Dump utility (ANALYZE/PROCESS_DUMP) 
RMS Analyze and FDL Editor utilities (ANALYZE/RMS, ANALYZE/FDL) 
Message utility (MESSAGE) 

Object and Shareable Image libraries 

MACRO libraries 

MACRO assembler 

SDL intermediary form of STARLET.MLB 

Fortran required files 

VAX C object libraries 

X/Open transport interface libraries 

OpenVMS RMS journaling files 


e System programming Support 


Files—11 ODS—1, ISO 9660, High Sierra ACPs 

Monitor utility 

Delta/XDelta debugger 

System Dump Analyzer utility (ANALYZE/SYSTEM, ANALYZE/CRASH) 
System Symbol Table file (SYS.STB) 

Miscellaneous symbol table files 


e Secure User’s Environment 


File Access Control List utilities 
Print and Batch Queue utilities 
Input Queue Symbiont (Card Reader) 
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Accounting Log Report Generator utility 
DECdtm 


e Utilities 


Mail utility 

DUMP utility 

RUNOFF utility 

Phone utility 

OpenVMS Help library 

Foreign Terminal Support 

LAT-11 terminal server (via Ethernet) 
Standalone backup 

Error Log Report Generator utility (ANALYZE/ERROR) 
DECTPU | 

Terminal Fallback Facility | 
National Character Set utility (NCS) 

C language internationalization utilities 


e TECO editor 
e EDT documentation 
e OpenVMS workstation support 


e Workstation device support 


D.2 Save Set D Subclasses 
The following files are contained in the Optional save set: 
¢ Miscellaneous files 
e System map 
e LPA-11 support 
e BLISS required files 
e UETP (the User Environment Test Package) 


e Example files 


D.3 Save Set E Subclasses 


The following files are contained in the Help Message save set: 


e Help Message database 


D.4 Save Set F Subclasses 


The following files are contained in the OpenVMS Management Station save set: 


e OpenVMS Management Station software PC files 
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DECwindows Display Server and Fonts 
Components 


This appendix provides a list of files provided by the DECwindows base and 
workstation support components included on the OpenVMS VAX distribution kit. 
E.1 Table of Components 


Table E—1 contains the name of the DECwindows display server and fonts 
components, the directory where the component can be found, a brief description 
of what the component does, and one of the following component classifications: 


e BASE—Indicates that the component is part of all installations. 
e Ws—Indicates that the component is part of the workstation support. 


e FONT—Indicates the component is part of the fonts component. 


Table E-1 DECwindows Display Server and Fonts Components 


File Purpose Component Class _ 
Files in DECWSKEYMAP Directory 
DECW$KEYMAP BASE 


Files in SYSSLOADABLE_IMAGES Directory | 


GAADRIVER.EXE VAXstation II/GPX driver WS 
GABDRIVER.EXE VAXstation 2000/GPX driver WSs 
GBBDRIVER.EXE VAXstation 35x0 driver WS 
GCADRIVER.EXE VAXstation II monochrome device driver WS 
GCBDRIVER.EXE VAXstation 2000 monochrome device driver _ WS 
GEBDRIVER.EXE | Scanproc graphics device driver WS 
GECDRIVER.EXE | Spxg/gt graphics device driver WS 
GFBDRIVER.EXE Low-cost graphics device driver WS 
IEDRIVER.EXE Input extension driver | WS 
IKDRIVER. EXE Keyboard decoder driver WS 
IMDRIVER.EXE Mouse decoder driver WS 
INDRIVER.EXE Common input function driver WS 
WSDRIVER.EXE Set display driver BASE 


(continued on next page) 
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E.1 Table of Components 


Table E-1 (Cont.) DECwindows Display Server and Fonts Components 


File 


DECW$FONTCOMPILER.EXE 
DECW$MKFONTDIR.EXE 
DECW$SERVER_MAIN.EXE 
DECW$SETSHODIS.EXE 


| See VMS DECwindows Xlib 
Programming Volume 


DECW$FONT_ALIAS_CHARTER.DAT 


DECW$FONT_ALIAS_CHARTER_ 
100DPI.DAT 


DECW$FONT_ALIAS_ 
FILENAMES.DAT 


DECW$FONT_ALIAS KANJI.DAT 
| DECW$FONT_ALIAS_LUCIDA.DAT 


DECW$FONT_ALIAS_LUCIDA_ 
100DPI.DAT 


DECW$DRIVER.MLB 
DECW$FONTCOMPILER.CLD 
DECW$SERVER_DDX_GA.EXE 
DECW$SERVER_DDX_GB.EXE 
DECW$SERVER_DDX_GC.EXE 


DECW$SERVER_DDX_GE.EXE 
DECW$SERVER_ DDX_GFEXE 


DECW$SERVER_DIX.EXE 
DECW$SERVER_XINPUT_IE.EXE 


DECW$SESSIONSHRP.EXE 


DECW$SVEXT_ADOBE_DPS_ 
EXTENSION.EXE 


DECW$SVEXT_D2DX_ 
EXTENSIONS.EXE 


DECW$SVEXT_DEC_XTRAP.EXE 


Purpose 
Files in SYS$SYSTEM Directory 


Font compiler image 
Font utility to generate list of fonts and paths 
Server main image _ 


SHOW DISPLAY command image 


Files in DECWS$FONT Directory 


DECwindows fonts 


Files in DECW$EXAMPLES Directory 


Example alias file for Charter fonts 


Example alias file for 100 dpi Charter fonts 
Brief alias name list for shipped fonts 


Example alias file for Kanjifonts 
Example alias file for Lucida fonts 


Example alias file for 100 dpi Lucida fonts 


Files in SYS$LIBRARY Directory 


Driver macro library 

CLD for font compile commands 

Server color device support shareable image 
Server color device support shareable image 


Server monochrome device support shareable 
image 


Server scanproc device-dependent shareable image 


Server low-cost graphics device- dependent 
shareable image 


Server device independent support 


Input extension for handling nonstandard input 
devices 


Support routines for DECwindows Session 
Manager 
Display PostScript server extension image 


DECwindows 2D extensions 


Input and event recording and playback extension 


E-2 DECwindows Display Server and Fonts Components 


Component Class 


FONT 
FONT 
ws 

BASE 


WS 


FONT 
FONT 


FONT 


FONT 
FONT 
FONT 


WSs 
FONT 
WS 
WS 
WS 


WSs 
WS 


ws 
ws 
BASE 
ws 


WS 


WS 
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File 


DECW$SVEXT_MULTI_ 
BUFFERING. EXE 


DECW$SVEXT_X3D_PEX.EXE 
DECW$SVEXT_X38D_PEX_GB.EXE 


DECW$SVEXT_X8D_PEX_GB_ 
UCODE.EXE 


DECW$SVEXT_X3D_PEX_GE.EXE 
DECW$SVEXT_X8D_PEX_STP.EXE 


DECW$SVEXT X3D_PEX STP_ 
UCODE.EXE 


DECW$SVEXT_X8D_PEX_VCFB.EXE 
DECWS$SVEXT_XIE.EXE 


DECW$SVEXT_ 
XINPUTEXTENSION. EXE 


DECW$TRANSPORT_COMMON.EXE 
DECW$TRANSPORT_DECNET.EXE 
DECW$TRANSPORT_LOCAL.EXE 
DECW$TRANSPORT_TCPIP.EXE 
DECW$XPORTCOM.H 
DECW$XPORTCOM.MAR 
DECW$XPORTCOM.R32 
DECW$XPORTDEF.H 
DECW$XPORTDEF.MAR 
DECW$XPORTDEF.R32 
DECW$XPORTMAC.R32 - 
DECW$XPORTMSG.R32 
XDPS$MASTERDPSVM.DAT 


DECW$DEVICE.COM 
DECW$DEVICE_GE.COM 
DECW$DEVICE_GF.COM 


DECW$DEVICE_GG.COM 
DECW$RGB.DAT 


DECW$STARTSERVER.COM 


Purpose 


Files in SYS$LIBRARY Directory 


DECwindows multi-buffering extension 


Phigs Extension to X (PEX) for 3D 
PEX for 35x0 systems 
PEX microcode for 35x0 systems 


PEX for scanproc systems 
PEX for scanproc systems with geometry processor 


PEX microcode for scanproc systems with geometry 
processor 


PEX color frame buffer (software PEX) 
DECwindows imaging extension 


DECwindows input extension 


Common transport shareable image 
DECnet transport image 
Local transport image 

TCP/IP transport image 
Common transport definitions 
Common transport definitions 
Common transport definitions 
Transport definitions 
Transport definitions 
Transport definitions 
Transport BLISS macros 
Transport message symbols 


Display PostScript support file 


Files in SYS$MANAGER Directory 


Device detection and configuration 
Scanproc device detection and configuration 


Low-cost graphics device detection and 
configuration 


Scanproc turbo device detection and configuration 


Definitions of the color names used by the 
XStoreNamedColor and XAllocNamedColor 
requests 


Server initialization and startup 
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DECwindows Display Server and Fonts Components . 
E.1 Table of Components 


Component Class 


WS 


WS 
WS 
WS 


WS 
WS 
WS 


WS 
WS 
WS 


BASE 
BASE | 
BASE 
BASE 
BASE 
BASE 
BASE 
BASE 
BASE 
BASE 
BASE 
BASE 
WS 


BASE 
WS 
WS 


WS 
WSs 


WS 


DECwindows Display Server and Fonts Components 
E.1 Table of Components 


Table E—1 (Cont.) DECwindows Display Server and Fonts Components 
File Purpose 
Files in SYS$MESSAGE Directory 


DECW$TRANSPORTMSG.EXE Transport message image 
Files in SYS$UPDATE Directory 


DECW$MKFONTDIR.COM Command file to invoke DECW$MKFONTDIR.EXE 
font utility 


E—4 DECwindows Display Server and Fonts Components 


Component Class 


BASE 


FONT 
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NEW_OVER and NEW_UNDER Files 


This appendix lists files installed either over or under existing files during an 
upgrade. 


F.1 Where Files Are Installed 


During an upgrade, the procedure replaces certain files that exist on your system 
with new versions of those files from the OpenVMS VAX distribution kit. For 
some system files, the upgrade procedure does not replace your existing system 
files, which might contain customizations for your site. Instead, the procedure 
retains your existing file and installs the new file from the kit at a version 
number higher or at a version number lower than your existing file. 


You can use the DCL command DIFFERENCES to compare the contents of your 
existing files and the contents of the new files provided by OpenVMS VAX Version 
7.1. Enter the command using the following syntax: 


DIFFERENCES/OUTPUT=filespec existing_filename new_filename 


The /OUTPUT qualifier causes the DIFFERENCES command to write the list of 

differences to the output file you specify. This output file will have the default file 
type .DIF. For more information about using the DIFFERENCES command, refer 
to the OpenVMS DCL Dictionary. 


New files that the procedure installs at a version number higher than your 
existing files are referred to as new_over files. You must use these files at least 
until you complete the upgrade. After you have upgraded your system, you can 
add your customizations to these files. 


New files installed at a version number lower than the existing files are referred 
to as new_under files. This allows you to continue to use your existing files 
during and after the upgrade. 


If you purge a new_over file, you are left with the new version of the file provided 
by the distribution kit, and any customizations you might have made to the 
existing file will be lost. If you purge a new_under file, you are left with the file 
that existed before the upgrade. 


In addition to the new_over and new_under files, there are certain files that are 
intended to contain your site-specific modifications. During an upgrade, the old 
versions of these files are retained if they were present before the upgrade. The 
new version of the file is installed only if no old version is present on your system. 
With the exception of TFF$STARTUP.COM, there is a corresponding .TEMPLATE 
file for each of the site-specfic files. The new version of the .TEMPLATE file 
replaces the old version. 
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F.1.1 NEW_OVER Files 


During an upgrade, the following new files are installed over (that is, at a version 
number higher than) the existing files: 


[SYSEXE]SHUTDOWN.COM 
[SYSEXE]STARTUP.COM 
[SYSHLP]HELPLIB.HLB 
[SYSLIBJADARTL.EXE 
[SYSLIBJBASRTL.EXE 
[SYSLIB]BASRTL2.EXE 
[SYSLIB]BLASIRTL.EXE 
[SYSLIB]JCOBRTL.EXE 
[SYSLIB]DBLRTL.EXE 
[SYSLIB]DCLTABLES.EXE 
[SYSLIB]JENCRYPSHR.EXE 
[SYSLIB]FORRTL.EXE 
[SYSLIB]FORRTL2.EXE 
[SYSLIB] IMAGELIB.OLB 
[SYSLIB]LBRSHR.EXE 
[SYSLIB]JLIBRTL.EXE 
[SYSLIB]LIBRTL2.EXE 
[SYSLIB]MTHRTL.EXE 
[SYSLIB] PASRTL.EXE 
[SYSLIB]PLIRTL.EXE 
[SYSLIB]PPLRTL.EXE 
[SYSLIB]RPGRTL.EXE 
[ISYSLIBJSCNRTL.EXE 
[SYSLIB]STARLET.OLB 
[SYSLIBJUVMTHRTL.EXE 
[SYSLIB] VAXCRTL.EXE 
[ISYSLIB]VAXCRTLG.EXE 
[SYSLIB] VBLASIRTL.EXE 
ISYSLIB] VMSRTL.EXE 
[SYSLIB]J VMTHRTL.EXE 
[ISYSMGR]DBLSTRTUP.COM 
[ISYSMGR] WELCOME.TEMPLATE 
[SYSMGR] WELCOME.TXT 


F.1.2 NEW_UNDER Files 


During an upgrade, the following new files are installed under (that is, at a 
version number lower than) the existing files: 


[SYS$LDRIVMS$SYSTEM_IMAGES.DATA 
[SYS$STARTUP]ESS$LAST_STARTUP.DAT 
[ISYS$STARTUP] VMS$LAYERED.DAT 
[SYSEXE] VMS$IMAGE_VERSION.DAT 
[SYSLIB]CDDSHR.EXE 
[SYSLIBJEPC$FACILITY.TLB 
[SYSLIBJEPC$SHR.EXE 

[SYSLIB] UISSHR.EXE > 
[SYSMSG]EPC$MSG.EXE 
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F.1.3 Site-Specific Files 


The following files are intended to contain site-specific modifications. Note that, 
with the exception of TFF$STARTUP.COM, there is a corresponding .TEMPLATE 
file for each of these files. The new version of the .TEMPLATE file replaces the 
old version. 


[SYSEXE]JSYSUAF. DAT 
[SYSMGRIAGEN$NEW_NODE_DEFAULTS.DAT 
[SYSMGRJAGEN$NEW_SATELLITE_DEFAULTS.DAT 
[SYSMGR]LAT$SYSTARTUP.COM 
[ISYSMGR]LOGIN.COM 
ISYSMGR]ISYCONFIG.COM 
ISYSMGRISYLOGICALS.COM 
ISYSMGR]SYLOGIN.COM 
[ISYSMGRISYPAGSWPFILES.COM 
[ISYSMGRISYSECURITY.COM 
ISYSMGRISYSHUTDWN.COM 
ISYSMGRISYSTARTUP_VMS.COM 
[SYSMGRITFF$STARTUP.COM 
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Preparing to Use OpenVMS Management 
Station 


This appendix describes how to prepare your OpenVMS system and your PC to 
run the OpenVMS Management Station server and client software. 


The OpenVMS Management Station is a client-server application that provides 
OpenVMS system management capabilities through a client application on a 
personal computer (PC) running Microsoft Windows. 


During the OpenVMS VAX installation or upgrade procedure, the OpenVMS 
Management Station server files are automatically installed on your OpenVMS 
system disk. However to obtain complete support, you must also select the 
OpenVMS Management Station client software files during the OpenVMS 
installation or upgrade procedure. Those files are required to create the 
installation media that you use to install the client software on your PC. 


If you did not select the OpenVMS Management Station component during the 
installation or upgrade, you must add those files to your OpenVMS system disk 
before you follow the instructions in this appendix. Use the OpenVMS VAX 
distribution media and VMSTAILOR to add the OpenVMS Management Station 
files to your system. (For information about using VMSTAILOR, see Chapter 10.) 


G.1 Preparing Your OpenVMS System 


You must prepare your OpenVMS system to run the server software so that 
your system can properly interact with the PC running the client software. The 
procedures include the following: 


e Set up within a mixed-architecture cluster environment (if applicable). 

e Start the server on other nodes. 

e Update the printer database. 

e Edit the system files. 

¢ Allow OpenVMS Management Station to control the printer environment. 
e Keep your printer environment up to date. 

e Check if running third-party TCP/IP stacks. 

e Recover from a failure. 


e Determine and report problems. 
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G.1.1 Files Installed on Your OpenVMS System 


The following files are created on your OpenVMS system when the i Eo 
Management Station server is installed: 


e SYS$SYSTEM:TNT$SERVER.EXE 

e SYS$STARTUP:TNT$STARTUP.COM 

© SYS$STARTUP:TNT$SHUTDOWN.COM 

e SYS$STARTUP:TNT$UTILITY.COM 

e SYS$TEST:TNT$IVP.COM 

e SYS$COMMON:|SYSTEST.TNT]TNT$SERVER_IVP.EXE 

e SYS$HELP:TNTV20.RELEASE_ NOTES 

These optional files are created when you install PC installation media files: 
¢ SYS$COMMON:|[TNT.CLIENTIDISKIMAG.EXE 

e SYS$COMMON:|[TNT.CLIENTITNTCLID1.IMG 

e SYS$COMMON:[TNT.CLIENT]TNTCLID2.IMG 

e SYS$COMMON:|TNT.CLIENT] TNTCLID3.IMG 

e SYS$COMMON:|TNT.CLIENTITNTCLID4.IMG 

e SYS$COMMON:[TNT.CLIENT]TNTCLID5.IMG 

¢ SYS$COMMON:[TNT.CLIENT]TNTCLID6.IMG 

These files are created when the server is started: 

© SYS$COMMON:ISYSEXE]TNT$UADB.DAT 

e SYS$COMMON:|[SYSEXE]TNT$ACS.DAT 

e SYS$COMMON:|SYSEXE]TNT$JOURNAL.TNT$TRANSACTION_JOURNAL 


G.1.2 Setting Up in a Mixed-Architecture Cluster Environment 
The OpenVMS Management Station server creates three main configuration files: 
¢ TNT$UADB.DAT 
¢ TNT$ACS.DAT 
¢ TNT$JOURNAL.TNT$TRANSACTION_JOURNAL 


In a common-environment cluster with one common system disk, you 1 use a 
common copy of each of these files located in the SYS$}COMMON:[SYSEXE] 
directory on the common system disk, or on a disk that is mounted by all cluster 
nodes. No further action is required. 


However, to prepare a common user environment for an OpenVMS Cluster system 
that includes more than one common VAX system disk or more than one common 
_Alpha system disk, you must coordinate the files on those disks. 


Rules: The following rules apply: 


e Disks holding common resources must be mounted early in the system startup 
procedure, such as in the SYLOGICALS.COM procedure. 


e You must ensure that the disks are mounted with each cluster reboot. 
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Follow these steps to coordinate files: 


1. Decide where to locate the files. In a cluster with multiple system disks, 
system management is much easier if the common system files are located on 
a single disk that is not a system disk. 


2. Copy TNT$UADB.DAT, TNT$ACS.DAT, and 
TNT$JOURNAL.TNT$TRANSACTION JOURNAL to a location other than 
the system disk. 


3. Edit the file SYS$SCOMMON:[SYSMGRISYLOGICALS.COM on each system 
disk and define logical names that specify the location of the cluster common 
files. 


Example: If the files will be located on $1$DJA16, define logical names as 
follows: 


$ DEFINE/SYSTEM/EXEC TNTSACS - 
_$ S$1SDJA16: [ VMSSCOMMON.SYSEXE]TNTSACS.DAT 


$ DEFINE/SYSTEM/EXEC TNTSUADB - 
_$ $1$DJA16: [ VMSSCOMMON. SYSEXE ] TNTSUADB .DAT 


$ DEFINE/SYSTEM/EXEC TNTSJOURNAL - 
_$ S1SDJA16: [ VMSSCOMMON. SYSEXE ] TNTSJOURNAL. TNTSTRANSACTION JOURNAL 


4. To ensure that the system disks are mounted correctly with each reboot, 
follow these steps: 7 | 


1. Copy the SYS$EXAMPLES:CLU_MOUNT_DISK.COM file to the 
[VMS$COMMON.SYSMGR] directory, and edit it for your configuration. 


2. Edit SYLOGICALS.COM and include commands to mount, with the 
appropriate volume label, the system disk containing the shared files. 
Example: If the system disk is $1$DJA16, include the following 
command: 


$ @SYSSSYSDEVICE: [ VMSSCOMMON.SYSMGR]CLU MOUNT DISK.COM - 
_$ $1$DJA16: volume-label 


G.1.3 Start the Server on Other Nodes 


If you plan to run OpenVMS Management Station on more than one node in 
an OpenVMS Cluster without a reboot, you need to start the software on those 
nodes. Enter the following command: 


S$ @SYSSSTARTUP: TNTSSTARTUP.COM 


If you are performing an upgrade or a reinstallation and OpenVMS Management 
Station is already running on the node, add the RESTART parameter to the 
startup command, as follows: 


S$ @SYSSSTARTUP: TNTSSTARTUP.COM RESTART 


G.1.4 _— the Printer Database 


When you installed OpenVMS Management Station, the installation started the 
OpenVMS Management Station server on the installation node and created an 
initial version of the printer database file TNT$ACS.DAT. However, this initial 
version of the database might not contain complete device and queue information 
for your OpenVMS Cluster system. | 
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To complete the database, first start the OpenVMS Management Station server 
on each node in your cluster. The instances of the server communicate with each 
other to determine device and queue information, and the server must be running 

on each node for this communication to take place. 


Once you have started the server on each node, run the following procedure to 
update the printer database: 


$ @SYSSSTARTUP: TNTSUTILITY UPDATE PRINTERS 


G.1.5 Edit the System Files 


To start the OpenVMS Management Station server from your system startup 
files, insert the following line into your system startup procedures (usually 
SYS$MANAGER:SYSTARTUP_VMS.COM) after both the Queue Manager and 
network are started, but before ENABLE AUTOSTART/QUEUES. 


S$ @SYSSSTARTUP:TNTSSTARTUP BOOT 


(The best place for this is immediately prior to the ENABLE AUTOSTART 
/QUEUES command.) 


Note 


Remove any other invocations of TNT$STARTUP you might have added 
in previous releases of the OpenVMS Management Station. 


OpenVMS Management Station cannot start until the network has 
started. If you start your network using a batch process, OpenVMS 
Management Station might start before the batch process completes and 
the network is started. | 


Add the following command line to the system shutdown file, 
SYS$SMANAGER:SYSHUTDWN.COM: 


$ @SYSSSTARTUP: TNTSSHUTDOWN.COM 


G.1.6 Allow OpenVMS Management Station to Control the Printer Environment 


Placing the server startup before ENABLE AUTOSTART/QUEUES in the system 
startup procedure allows the server to start any queues not already started by 
your existing DCL command procedures. 


It is not necessary to remove your existing queue startup DCL procedures 
immediately. The OpenVMS Management Station server will recognize that you 
started a queue with your command procedures and will assume that you want it 
that way. 


As you become familiar with the server’s management ability, you can remove or 
comment out the DCL commands and procedures that perform these tasks and 
allow OpenVMS Management Station to control your printer environment. 


G.1.7 Keep Your Printer Environment Up to Date 


The OpenVMS Management Station server installation creates a file named 
SYS$STARTUP:TNT$UTILITY.COM. This command procedure scans the 
OpenVMS system and updates the database of known printers, queues, and 
related devices. TNT$UTILITY.COM runs at regular intervals to keep the 

_ database files synchronized with the actual system. | 
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G.1.7.1. When Does TNT$UTILITY.COM Run? 
The TNT$UTILITY.COM procedure runs: 


e As part of the OpenVMS Management Station installation. 
¢ When you specifically invoke it. 


e At periodic intervals as a background thread. Two logical names control how 
often it runs: 


Logical Name Description 

TNT$PRINTER_RECON How often TNT$UTILITY.COM should run, in minutes, from 

INTERVAL when the server was last started on this node. If you do 
not define this logical, the default value is 1440 minutes (24 
hours). 

TNT$PRINTER_RECON_ The minimum number of minutes that must elapse before 

INTERVAL_MIN TNT$UTILITY.COM should run again, starting from when 


the database was last updated. If you do not define this 
logical, the default value is 60 minutes (1 hour). 


You can think of these logicals as meaning “run TNT$UTILITY.COM this 
often (TNT$PRINTER_RECON_INTERVAL), but make sure this much time 
has elapsed since the database was last updated (TNT$PRINTER_ RECON _ 
INTERVAL_MIN).” 


Because you can run TNT$UTILITY.COM yourself, and because the OpenVMS 
Management Station server also updates the database, the TNT$PRINTER_ 
RECON_INTERVAL_MIN logical prevents the database from being updated more 
frequently than is actually needed. 


If you want to change the defaults for one of these logicals, define the logical on 
all nodes on which the OpenVMS Management Station server is running. 


G.1.7.2_ Do You Need to Run TNTSUTILITY.COM Manually? 


If you use OpenVMS Management Station to make all of the changes to your 
printer configuration, the configuration files are immediately modified to reflect 
the changes and you probably do not need to specifically run TNT$UTILITY.COM. 
TNT$UTILITY.COM runs at periodic intervals as a background thread to make 
sure that the database is kept up to date. 


However, if you or someone else uses DCL to make a change — for example, if 
you use the DELETE /QUEUE command to delete a queue — the configuration 
files will not be synchronized. In this case, the OpenVMS Management Station 
client will advise you to run TNT$UTILITY.COM to resynchronize the database. 


Run the following procedure on one node in the cluster to make the database 
match your system: 


S$ @SYSSSTARTUP: TNTSUTILITY.COM UPDATE PRINTERS 


For example, if you or someone else used DCL to delete a queue, you need to 
delete that queue from the database. TNT$UTILITY.COM assumes that your 
system is set up and running the way that you want it to, so you au fix any 
problems before you run TNT$UTILITY.COM. 
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G.1.7.3. Are There Any Requirements for Running TNT$UTILITY.COM? 


You need the SYSNAM privilege to run TNT$UTILITY.COM. 


TNT$UTILITY.COM connects to the OpenVMS Management Station server 
on the current OpenVMS system to determine device and queue information. 
Therefore, the OpenVMS Management Station server must be running on the 
node where you run TNT$UTILITY.COM. 


The OpenVMS Management Station server then connects to the other OpenVMS 
Management Station servers in the OpenVMS Cluster to determine device and 
queue information. It is generally a good idea to keep the OpenVMS Management 
Station server running on the other nodes in an OpenVMS Cluster to keep the 
database up to the minute. 


However, if the OpenVMS Management Server is not able to connect to the 
OpenVMS Management Station server on a given node, it uses the known 
information about that OpenVMS node from the database. That is, in the absence 
of a valid connection to that OpenVMS node, the information in the database is 
assumed to be correct. : 


G.1.8 Enabling Disk Quotas 


Before installing OpenVMS Management Station, you might have disabled disk 
quotas on the SYSTEM disk. If so, you should reenable the quotas and then 
rebuild to update quota information by entering the following commands: 


S RUN SYSSSYSTEM:DISKQUOTA — 
DISKQUOTA> ENABLE 

~ DISKQUOTA> REBUILD 
DISKQUOTA> EXIT 


G.1.9 Running Third-Party TCP/IP Stacks 


Digital TCP/IP Services for OpenVMS Version 3.2 or higher is the only supported 
TCP/IP stack. Additional stacks have not been tested. However, TCP/IP stacks 
that are 100% compliant with the QIO interface for TCP/IP Services for OpenVMS 
should also work. (Contact your TCP/IP vendor for additional information and 
support issues.) 


For the best chance of success, check the following: 
e Make sure that the QIO service (for example, UCXQIO) is enabled. 


e For TCPware, also make sure that TCPware’s UCX$IPC_SHR.EXE is an 
installed image. 


G.1.10 Determining and Reporting Problems 


_If you encounter a problem while using OpenVMS Management Station, please 
report it to Digital. Depending on the nature of the problem and the type of 
support you have, you can take one of the following actions: 


e If your software contract or warranty agreement entitles you to telephone 
support, call Digital. 


e Ifthe problem is related to OpenVMS Management Station documentation, 
use the Internet address printed in front of this book to send us your 
comments. 
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G.2 Preparing Your PC 


During the OpenVMS Version 7.1 installation or upgrade procedure, you selected 
the OpenVMS Management Station client software files to be installed on your 
OpenVMS system disk (or you added them later using the DCL command 
PRODUCT RECONFIGURE VMS). After you have prepared your OpenVMS 
system to run the server software, you must next prepare your PC to run the 
client software. 


This section includes the following information: 
e Required memory and disk space 

e Required software 

e TeamLinks support 

e Creating the installation media 

e Installing the client software 


e Getting started using OpenVMS Management Station 


G.2.1 Required Memory and Disk Space 


Your PC requires 8 MB of random-access memory (RAM) and 11.5 MB of free disk 
space to install the OpenVMS Management Station client software. 


G.2.2 Required Software 


Table G—1 describes the software that must be installed on your PC before 
installing OpenVMS Management Station. 


Table G-1 Prerequisite and Optional Software for PCs 
Prerequisite Products Purpose 


Microsoft Windows NT Version 3.51 Operating system 


or 
Microsoft Windows 95 

or 

Microsoft Windows Version 3.1 


or 
Microsoft Windows for Workgroups 
Version 3.11 


Optional Products Purpose 

PATHWORKS Version 5.1 for DOS and Integrate with PATHWORKS, 
Windows client software DECnet support 
ManageWORKS Workgroup ManageWORKS integration 
Administrator, Version 2.2 ; 


Your TCP/IP stack IP connections 


PATHWORKS for Windows 95 and any version of Windows NT prior to Version 
3.51 are not officially supported. 
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G.2.3 TeamLinks Version 1.0 is Not Supported 


If Version 1.0 of TeamLinks is installed on your PC, the OpenVMS Management 
Station PC installation program will ask whether to update the XTI library 
component of TeamLinks. | 


If you answer No, the OpenVMS Management Station installation terminates. 
However, if you allow OpenVMS Management Station to update the XTI library, 
Version 1.0 of TeamLinks will no longer work. 


The version of the XTI library included with Version 1.0 of TeamLinks does not 
allow TCP/IP connections from your PC and is not supported in this version of 
OpenVMS Management Station. If you want to utilize both TCP/IP connections 
and TeamLinks, you must upgrade to a higher version of TeamLinks. 


G.2.4 Creating the Installation Media 


Create the PC installation media using the following procedure. 
Note: You need six formatted 3-1/2-inch, high-density floppy disks. 


1. For PCs running TCP/IP, at the MS-DOS prompt use the FTP utility on the 
PC to copy the files by entering commands similar to the following: 


C:\> cd temp-dir 

C:\temp> ftp 

ftp> open node 

Connected to node 

Username: username 

Password: password 

User logged in. 

ftp> cd sys$common: [tnt. client] 
ftp> type bin 

ftp> mget *.* 


where node, username, and password are the access control information for an 
account on the OpenVMS system, and temp-dir is the name of the temporary 
directory. 


2. For PCs running DECnet, at the MS-DOS prompt use the NFT utility on the 
PC to copy the files by entering the following command: 


C:\> NFT COPY /BLOCK node"username password": :SYSSCOMMON: 
[TNT.CLIENT]*.* \temp-dir 


where node, username, and password are the access control information for an 
account on the OpenVMS system, and temp-dir is the name of the temporary 
directory. The node name must be defined in the PC’s network database. 


3. Insert a formatted floppy disk in the 3-1/2-inch floppy disk drive (A in this 
_ example). At the MS-DOS prompt, type the following MS-DOS command: 


C:\> \temp-dir\DISKIMAG \temp-dir\TNTCLID1.IMG A: 


where temp- -dir is the temporary directory used in step 2. 


When the DISKIMAG program returns to the MS—DOS prompt, remove ne 
floppy disk and label it “Disk 1—Setup.” 


Repeat this process for TNTCLID2.IMG through TNTCLID6.IMG 


You can delete the files DISKIMAG.EXE and TNTCLID1.IMG through 
TNTCLID6.IMG from temp-dir after creating the floppy disks. 
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G.2.5 Installing the OpenVMS Management Station Client Software on Your PC 


This section provides the following information: 


How to install the OpenVMS Management Station client on a PC 

How to recover from errors during the installation 

How to define DECnet nodes after the installation 

The names of the files that are created on your PC after the installation 


How to access online help to get started using OpenVMS Management Station 


G.2.5.1 Installation Directory 


The installation procedure allows you to select the installation directory, and 
suggests \ VMSTNT as the default. 


Do not install OpenVMS Management Station into the PATHWORKS or 
ManageWORKS Workgroup Administrator directories. If you do want to configure 
PATHWORKS or ManageWORKS Workgroup Administrator to load OpenVMS 
Management Station, see Section G.2.7. 


G.2.5.2 Installation Procedure 
Follow these steps to install OpenVMS Management Station client: 


1. 


2 
3. 
A 


Start your PC as you usually do. 
Insert disk 1 in your floppy disk drive. 
Enter the Windows environment and click on the Program Manager icon. 


In the Menu bar of the Program Manager program group, click on File, and 
then choose Run from the pull-down menu. 


Result: The Run dialog box appears. 

In the Run dialog box, type: 

A:\SETUP.EXE 

where A: is the name of the floppy disk drive. 
Click on the OK button to start the installation. 


Result: A dialog box containing the message “Initializing setup, please 
wait...” appears. You are then prompted to continue. 


To proceed with the installation, click on the Next button. 


Note: You can stop the installation at any time by clicking on the Cancel 
button. 


As the installation progresses, the system displays a status bar indicating 
what percentage of the installation is done. Also displayed is a reminder 
to read the OpenVMS Management Station Read Me file for important 
information. | | 


When you are prompted by a dialog box message, remove disk 1 from the disk 
drive and insert disk 2. Click on OK. 


Repeat this process for the remaining disks. 
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G.2.5.3 Recovering from Errors 


If an error occurs during installation, you will receive an error message describing 
the problem. This information can help you determine the cause of the problem. 
An error can occur during the installation if one or more of the following 
conditions exist: 


e The operating system version is incorrect. 
e The prerequisite software version is incorrect. 
e Disk space and memory necessary for successful installation are inadequate. 


G.2.5.4 Files Created on the PC 


The following files (with their directory names) are created on your PC after the 
OpenVMS Management Station client software is installed: 


e OpenVMS Management Station directory (usually \VMSTNT) 
— VMSACNT.DLL 
— VMSACNT.HLP 
— VMSCLU.DLL 
— VMSCUSCT.DLL 
— VMSINFRA.DLL 
-— VMSMGMT.DLL 
— VMSMGMT.HLP 
—~ VMSMSCRL.DLL 
— VMSNODE.DLL 
— VMSPRINT.HLP 
— VMSSCOPE.HLP 
— VMSTAB.DLL 
— VMSTIMEL.DLL 
— VMSUAOMM.DLL 
— CLASS.IDX 
— CLASS.POD 
—- CONTAIN.DLL 
— CONTAIN.IDX 
— CONTAIN.POD 
— DISPATCH.DLL | 
—- MWBROWSE.DLL 
— MW_OEM.DLL 
—~ MW_OEM2.DLL 
— MW_OEMS3.DLL 
— OMMLIB.DLL 
—- OBJECT.POD 
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—~ OBJECT.IDX 
— POD.DLL 
— PRMAKTPL.EXE 
— PWMGMT.EXE 
— PWMGMT.HLP 
— PWMGMTINI 
— PWSHELL.DLL 
— SVN.DLL 
—~ SVNVIEW.DLL 
— XMEM.DLL 

e Windows directory (usually \WINDOWS) 
— XTIDNW.DLL 
— XTILIB.DLL 
— XTIWINS.DLL 
— VMSTNT.INI 

e Windows systems directory (usually \WINDOWS\ SYSTEM) 
—- CTL8DV2.DLL 
— COMPOBJ.DLL 
— MFC250.DLL 
— MFC0O250.DLL 
— MFCOLEUIDLL 
—- OLE2.DLL 
— OLE2DISP.DLL 
— QOLE2NLS.DLL 
— STORAGE.DLL 


G.2.6 After Installing the Client Software on Your PC 


OpenVMS Management Station allows you to use both the TCP/IP and DECnet 
transports to establish connections. 


You can have a mix of DECnet and TCP/IP connections, all DECnet connections, 
or all TCP/IP connections. OpenVMS Management Station does not have any 
DECnet dependencies and can run in a TCP/IP-only environment. Note that 
Windows NT and Windows 95 support TCP/IP connections only. 


You do need to make sure that your PC can connect to the primary-server 
systems, as described in the following sections. OpenVMS Management Station 
connects your PC to the primary-server system and then routes management 
operations to the target systems. 
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G.2.6.1 Defining TCP/IP Nodes 


If you select the TCP/IP transport, your host’s file or name server must be able 
to resolve the IP name or address of all primary-server systems. If you can 
successfully ping the primary-server systems from your PC, then this condition is 
met. : 


G.2.6.2 DECnet Support 


If you want to use DECnet connections, PATHWORKS Version 5.1 for DOS and 
Windows must be installed somewhere on the PC and listed in the PC’s path 
statement. 


Define the DECnet node names and network addresses of primary-server 
OpenVMS systems that you want to manage. 


G.2.6.3 Procedure for Defining DECnet Nodes 
Follow these steps to define DECnet nodes: 


Step Action 


1 At the MS—DOS prompt, invoke the NCP utility as follows: 
C:\> NCP 
2 At the NCP> prompt, type the following command: 


NCP> DEFINE NODE addrs NAME name 
where addrs is the DECnet address and name is the DECnet node name. 
Example: 
NCP> DEFINE NODE 19.208 NAME ISTAR 
3 At the NCP prompt, type EXIT and press Return to exit the operation. 


G.2.7 PATHWORKS and Workgroup Administrator Support 


You no longer need the PATHWORKS client software to run OpenVMS 
Management Station. OpenVMS Management Station installs into its own 
directory and includes all of the ManageWORKS components it needs to run. 


If you happen to have PATHWORKS or ManageWORKS Workgroup 
Administrator installed, both will continue to function independently of OpenVMS 
Management Station. 


You can configure PATHWORKS Version 5.1 for DOS and Windows or the 
ManageWORKS Workgroup Administrator Version 2.2 to load the OpenVMS 
Management Station software if you want to. 


To do this, run the ManageWORKS Setup application and use the Browse 
feature to select the file ARGUS.MMI in the VMSTNT directory. Refer to the 
ManageWORKS online help for step-by-step instructions. | 

G.2.8 POLYCENTER Manager on NetView for Windows NT, Version 3.0 


You can launch OpenVMS Management Station from POLYCENTER Manager 
on NetView for Windows NT, Version 3.0. To do this, copy the file VMSTNT.REG 
from the temporary directory (or disk 1 if you requested client media) to the 
following directory: | 


\usr\ov\registration\c\ 


Note that NetView can be installed only on an NTFS partition. 
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G.3 Getting Started with OpenVMS Management Station 


All information about getting started, setting up, and using OpenVMS 
Management Station is contained in online help and the OpenVMS Management 
Station Overview and Release Notes. 


G.3.1 Accessing Online Help 
Follow these steps to access the OpenVMS Management Station online help: 


1. Open the OpenVMS Management Station program group. 


2. Click on the OpenVMS Management Help icon for instructions on how to get 
started. 
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H.1 Overview 


This appendix describes some methods you can use to manage small capacity 
system disks, along with some specific recommendations for installing 

or upgrading to OpenVMS VAX Version 7.1 and DECwindows Motif for 
OpenVMS VAX Version 1.2—3 on an RZ24, RA80, or RM80 system disk. (These 
recommendations will also work for Versions 1.1 and 1.2 of the DECwindows 
Motif for OpenVMS VAX layered product.) 


Note that you can use the methods described in this appendix to free disk space 
on any space-constrained system. 


H.2 Limited Space Support 


As the OpenVMS VAX operating system and associated layered products continue 
to develop and mature, their sizes have grown so that previously acceptable 
system disk devices might now have insufficient capacity for the desired 
computing environment. Support for added features, conformance to standards, 
addition of online documentation, and especially, support for a graphical user 
environment (specifically, DECwindows Motif) have contributed to this growth. 
Although a single-user workstation system might be perceived as entry level, 

it does, in fact, have an increased need for system disk capacity to handle the 
desired graphical environment. 


H.2.1 Limited Space Support Option 


In the past, when the OpenVMS VAX operating system grew too large for a 
specific disk type, that disk was no longer supported as a system device. The 
OpenVMS VAX Version 7.1 operating system and the DECwindows Motif for 
OpenVMS VAX Version 1.2—3 layered product cannot fit, in total, on an RZ24 disk 
device. 


However, to preserve the investment in some user configurations, a limited 
space support option has been introduced that will allow the RZ24 to continue 
to be used as a system disk but with some features removed. For the most part, 
these features include new online documentation, programming examples, and 
programming support files. The most important mechanisms used to provide 
this environment are the OpenVMS VAX and DECwindows tailoring facilities, 
VMSTAILOR and DECW$TAILOR. (For more information about these facilities, 
see Chapter 10.) , | 


The limited space support option means that, although the disk (in this case, the 
RZ24) is supported as a system device, you must take some explicit action to not 
install or to remove some portions of the product so the remainder will fit. This 
option gives small, resource-constrained system users a choice between investing 
in new hardware or continuing with existing hardware but with (possibly) 
reduced capabilities. 
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H.2.2 Configurations Affected 


The RZ24 disk is now too small for the full OpenVMS VAX Version 7.1 and 
DECwindows Motif for OpenVMS VAX Version 1.2—3 kits, regardless of user 
configuration. Other disk devices, such as the RZ24 and RD54 disks, will 
need to be closely monitored, depending on the system environment and user 
configuration. 


The general disk space guideline for OpenVMS VAX plus DECwindows Motif for 
OpenVMS VAX Version 1.2—3 is a system disk of at least 213 megabytes (or about 
377,000 disk blocks). For nonworkstation, single-user systems, this guideline 
can be reduced to about 125 megabytes because DECwindows support is not 
necessary. For timesharing systems, a larger disk is usually necessary due to 
the need for many layered products and applications. For VAXcluster systems, a 
larger system disk capacity is also usually required. See the VAXcluster SPD for 
details. 


For specific information about disk space requirements and supported system 
disks, see the OpenVMS VAX SPD. 


While the absolute minimum disk space requirements can make base system 
support available, layered products, applications, and user files usually make it 
necessary to manage even large capacity system disks carefully. Therefore, some 
of the following techniques and ideas can be useful for a broader range of users 
than can be listed by hardware type. 


H.2. 3 Dealing with a Small System Disk 


You can solve small system disk configuration problems three ways: 
e Upgrade your hardware to a larger capacity disk device. 


e Add additional hardware disk devices (one or more) to the system and 
redistribute the software contents. 7 


e Reduce the software contents on the existing disk device. 


Upgrading hardware might have the highest monetary cost, but has the benefits 
of a full environment and the simplest and fastest upgrade mechanism. Adding 
additional hardware (or using existing extra hardware) can require less 

money, but requires more time and effort for setting up and maintaining the 
environment. Reducing the software contents requires the lowest capital expense 
but, by necessity, removes some features, documentation, or capabilities. 


If your major constraint is fiscal, you might want to investigate the tailoring 
recommendations first. If time or simplicity are more important, you might want 
to purchase a larger system disk. 


H.3 Tailoring Considerations 


Most of this appendix describes the mechanisms for reducing the software 
contents on the existing disk device, mostly by tailoring. There are also some 
hints for multiple disk systems. There is nothing specific to recommend for 
upgrading the hardware device, except that moving up in a single large: increment 
is much more effective than several smaller ones. 


The target device in the following sections is the RZ24 disk, which has 209 
megabytes of disk space. However, you can use these methods on any system that 
is tight on system disk space. 
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H.3.1 Configuration Goals 


The basic configuration goal for the limited space support option is for an 
environment that is not used for programming. Typically, this would be a system 
with a few user applications or a turnkey system. It is possible to build a 
viable system with a single programming language environment (notably, the C 
language); however, the space used for this support and for the compiler reduces 
the amount of available user space. 


There are some mechanisms and techniques common to any space-constrained 
system both for installing new systems and for upgrading existing systems. One 
of the most important considerations is to reduce the disk space consumption of 
the normal, ongoing system environment before doing an upgrade or as soon as 
possible during or after an installation. Some methods for accomplishing this are 
discussed in Section H.6 and in Section H.7. 


Note that, during an upgrade or installation, there will be a period of time 
when the windowing software is likely to be unavailable. This means that, on a 
workstation, your monitor will function only as an operator console, and you will 
not be able to use screen-oriented editors. 


H.3.2 Controlling the Size of Dump, Page, and Swap Files 


One of the primary things to control is the sizing of the dump, page, and swap 
files in AUTOGEN. The tailoring facilities automatically use AUTOGEN to reboot 
the system, adjusting anything that the tailoring might have affected. Because 
AUTOGEN normally includes existing disk space in calculating the sizes for 
these files, unexpected results can occur when tailoring removes some files and 
AUTOGEN increases the size of others. Fixing the size of these files by adding 
appropriate lines to the file SYS$SYSTEM:MODPARAMS.DAT will prevent this 
from occurring during an upgrade or after an installation (and, possibly, while 
installing layered products). 


The following values are suggested as generous for an upgrade: 


PAGEFILE = 38000 © 
SWAPFILE = 13500 


DUMPFILE = 0 
If your system has been running successfully with smaller values, use those 
instead. 


If your windowing system is unavailable, you will not be able to use a screen- 
oriented editor to add these lines to the SYS$SYSTEM:MODPARAMS.DAT file. 
You can use the COPY command to add lines to the end of the text file as follows: 


$ COPY SYSSSYSTEM:MODPARAMS .DAT,SYSSINPUT: SYSSSYSTEM:MODPARAMS . DAT |Return] 
newparaml = valuel 
newparam2 = value2 


Note 


To be able to use the delete key more effectively when typing input to 

the console, set the operator terminal to be a scope (assuming it is not 
a hardcopy device). To set the console terminal to be a scope, enter the 
following command: 


$ SET TERM/SCOPE/PERM OPA0: 
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H.3.3 Make a Backup Copy of Your System Disk 


It is important to make a backup copy of your system disk before any system 
software upgrade. When tailoring and system environment options must be used 
to fit the required software on the device, it is even more important to make a 
backup copy before you begin and at major milestones during the procedure. This 
gives you a fallback to a last good position in the event that a subsequent step 
produces undesired side effects (especially when tailoring software off of the disk) 
or fails due to unexpectediy running out of space. 


—H.3.4 Analyze the System Disk 


The space used on the system disk might include files that have been only 
partially deleted (usually, because they were still open when an attempt was 
made to delete them). To recover this space, enter the following command: 


$ ANALYZE/DISK/REPAIR SYSSSYSDEVICE: 


- Continue to use the ANALYZE/DISK/REPAIR command after every reboot or 
before each major step to be sure that all free blocks are available for the upgrade 
procedure to use. 


H.3.5 Tailoring Options 


The installation and upgrade procedures (for both OpenVMS VAX Version 7.1 and 
DECwindows Motif) let you select optional software to install or upgrade only by 
save set. The tailoring facilities are capable of finer granularity and can usually 
select files in smaller groups within the save sets. 


In the case of DECW$MOTIF_TAILOR, the save sets and tailoring groups are 
the same. Additionally, DECW$MOTIF_TAILOR can only tailor off. To add 
files, you must either use the installation or upgrade procedures or use the 
OpenVMS Backup utility (BACKUP) manually to select the desired files. For the 
VMSTAILOR and DECW$TAILOR utilities, the tailorable options are subsets 

of the installation and upgrade save sets and can be tailored either on or off. If 
there is sufficient space to take an entire save set, it is usually faster to select it 
during the procedure and then tailor off the undesired pieces, rather than tailor 
them on later. 


If you are doing an upgrade and have a large area of user application files or 

a large database that is not part of the OpenVMS VAX operating system or 
DECwindows Motif layered product but resides on the system disk, it might be 
convenient to back up that data to a separate piece of media, delete it from the 
system disk before the upgrade, and then restore it after the upgrade. The blocks 
can be used in the interim, and you can save time and effort in the tailoring and 
upgrade process. | | 


You can decrease the time needed to perform the tailoring and upgrade tasks by 
disabling highwater marking on the system disk. To disable highwater marking, 
enter the following command: 


S$ SET VOLUME/NOHIGHWATER SYSSSYSDEVICE: 


Depending on the system security you require, you might want to leave highwater 
marking permanently disabled. Otherwise, you can restore it by entering the 
following command: 


S SET VOLUME/HIGHWATER SYSSSYSDEVICE: 
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H.4 Installing OpenVMS VAX and DECwindows Motif 


In general, installing OpenVMS VAX Version 7.1 and DECwindows Motif for 
OpenVMS VAX Version 1.2—3 is easier than doing an upgrade because there are 
no user files on the disk when you perform the installation. However, because the 
total size of the two kits is larger than the capacity of the RZ24 disk, you cannot 
select some options and you might have to do some tailoring. 


H.4.1 Install OpenVMS VAX Version 7.1 


By itself, the entire OpenVMS VAX Version 7.1 distribution kit fits on the RZ24 
system disk. So, the easiest approach might be to select both the library and 
optional save sets, then use the VMSTAILOR and DECW$TAILOR utilities to 
increase the free space before installing the DECwindows Motif layered product. 


If you plan to run DECnet for OpenVMS, be sure to select the library save set. If 
you do not perform system programming or BLISS programming, do not have an 
LPA11 device, do not need any of the OpenVMS example files, and do not need 
the UETP facility, you can choose not to select the optional save set during the 
installation. The BLISS support in the optional save set (approximately 7000 
blocks) and the examples (over 8500 blocks) are two of the largest single areas 
that you can easily tailor off. 


You might choose not to install the Help Message utility (MSGHLP) because this 
option is also very large (8900 blocks). Or, you can select it at the expense of 
other tailorable options later (or at the expense of reduced user capacity). 


Once the OpenVMS VAX installation is complete, set up the dump file as 
required. It is preferable not to have a dump file at all or to use the paging file 
as described in Section H.6.1. Also, set fixed sizes for the page and dump files so 
that AUTOGEN does not continually resize them as you proceed with tailoring 
and installing the DECwindows Motif for OpenVMS layered product. When your 
environment is complete, you can remove the fixed sizes to allow AUTOGEN to 
calculate appropriate sizes based on the final space on the disk. 


To fit the operating system on an RZ24 disk and have sufficient space to add some 
layered product or application packages and have user space remaining, you can 
generally support, at most, one programming language and no online examples or 
manuals. Use the VMSTAILOR and DECW$TAILOR utilities to remove software 
you do not need. 


H.4.2 Install DECwindows Motif 


Depending on the options and setup of your system, you might have sufficient 
space to install the entire DECwindows Motif for OpenVMS kit. However, it is 
likely that you again will need to remove support for all but one programming 
language and not include the examples. Because the programming support save 
sets for each language are large, choose only the support for languages you really 
need. In the case of the example files, you might want to install them if you 
have the space required, and then tailor them off once you have perused them or 
copied them to another area. 


Remember to use the ANALYZE/DISK/REPAIR command to recover any lost 
space from partially deleted files. 
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H.5 Upgrading OpenVMS VAX and DECwindows Motif 


- The following sections describe how to upgrade to OpenVMS VAX Version 7.1 
with the DECwindows Motif Version 1.2—3 layered product from an OpenVMS 
Version 6.1 or 6.2 system running VMS DECwindows Motif Version 1.1. (Note 
that Version 1.1 is the minimum version of DECwindows Motif that you can run 
on OpenVMS VAX Version 7.1.) 


This option requires the most attention and extra tailoring consideration because 
the disk blocks used by the DECwindows Motif layered product cannot be used 
during the OpenVMS VAX upgrade procedure. This means that you might not be 
able to select even the library save set during the upgrade and that you would 
need to tailor on portions of it (most notably, the DECnet support). 


Depending on your configuration, it might be necessary to tailor off DECwindows 
Motif and then reinstall it following the upgrade. 


H.5.1 Upgrading to OpenVMS VAX Version 7.1 


Before beginning the upgrade procedure, prepare the system environment— 
notably the dump, page, and swap files (see Section H.3.2)—and remove as many 
excess files from the system disk as possible. Use the tailoring facilities to remove 
files that will be replaced or obsoleted by the upgrade procedure. This is a good 
way to get the necessary space (48,950 blocks) to start the upgrade but probably 
will not contribute to the final additional capacity required. 


Tailor off all the OpenVMS programming files, examples, and miscellaneous 
utilities and any DECwindows Motif support that is not required. Before 
upgrading the operating system, keep, at most, one language support option, and 
do not keep any DECwindows Motif examples unless you have sufficient space 
to get at least the OpenVMS VAX required and library save sets directly in the 
upgrade. 


If you have sufficient space after tailoring to allow both the OpenVMS VAX 
required and library save sets to be selected, then the upgrade will include 
DECnet support and DECwindows Motif will start normally after the upgrade. 


If you cannot select the library save set, the lack of DECnet support will likely 
keep DECwindows Motif from starting on your system (at which point you will 
have only the operator window on your workstation). You can then tailor on the 
DECnet support to get DECwindows Motif for OpenVMS running again. After 
you have DECwindows Motif running, tailoring on any other pieces you might not 
have already acquired from either the library or optional save sets will be easier. 


Digital recommends that you not take the optional Help Message utility (unless 
you install it on an alternate device). You will want to choose the DECwindows 
device support if you are upgrading a workstation. 


Remember to use the ANALYZE/DISK/REPAIR command to clean up any 
partially deleted files. 


H.6 Managing Single or Small System Disk Systems 


The primary goal for this type of environment is to reduce the system disk block 
usage incurred by the OpenVMS VAX system during normal operation. Both | 
dynamic usage and static requirements can be reduced in various ways. Some 
system processing overhead can also be reduced or eliminated in this fashion, 
along with a corresponding reduction in system disk I/O. 
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H.6.1 System Dump File 


One of the best mechanisms for reducing the total block overhead of the system is 
to carefully define the usage of the system dump file. Normally, this is configured 
as a separate file, SYS$SSYSTEM:SYSDUMP DMP, to which the contents of 
memory are written after a detected system failure. Depending on your system 
requirements, you might be able to reduce or eliminate this disk usage. 


One effective technique is to use part of the system paging file, 
SYS$SYSTEM:PAGEFILE.SYS, as a temporary dump file, so that the space 
used for dump files is not permanently reserved and gets used only in the event 
of a crash. To do this, you will need to modify some system parameters in 
SYS$SYSTEM:MODPARAMS.DAT and delete the actual SYSDUMP.DMP file 

if it exists. This method is most effective for systems having small or medium 
memory sizes. 


Alternately, you might set the DUMPSTYLE parameter to use the selective dump 
mechanism to reduce the size of the dump file. This method is typically used for 
large memory systems that do not need to preserve the entire memory contents 
in the event of a system failure. Instead of using selective dumps to the paging 
file, keep a separate, but smaller, SYSDUMP.DMFP file. | 


If you have no need to preserve dump files or are running in a very stable 
environment, you might want to clear the DUMPBUG parameter to avoid all 
dump processing and not write a dump file on failure. 


H.6.2 Using PAGEFILE.SYS for the Dump File 


To use the system paging file as a dump file, add the following lines to the 
SYS$SYSTEM:MODPARAMS.DAT file: 


DUMPBUG = 1 ! Enable system dumps (default) 

SAVEDUMP = 1 ! Keep dump in pagefile until analysis 

DUMPFILE = 0 ! Disallow AUTOGEN to create or size dump file 

Then delete the SYSDUMP.DMP file by entering the following command: 
$ DELETE SYSSSYSTEM:SYSDUMP.DMP;* 


Because the system currently has the file open, the delete command will not 
physically remove the file until the system is shut down and rebooted. Use 

the AUTOGEN facility to reboot the system. When it has rebooted, enter the 
following command to clean up and finish the deletion of the file (and any others 
that were in a similar state): 


$ ANALYZE/DISK/REPAIR SYSSSYSDEVICE: 


After a system failure that writes dump information to the pagefile, you can 
analyze the data by entering the following command: 


S$ ANALYZE/CRASH SYSSSYSTEM: PAGEFILE.SYS 


When your analysis is complete, you can free the pages to be used for paging once 
again by entering the following command: 


$ ANALYZE/CRASH/RELEASE SYSSSYSTEM: PAGEFILE.SYS 


For more information about the system dump file, see the OpenVMS VAX System 
Dump Analyzer Utility Manual. 
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H.6.3 Decompressing Libraries 


The OpenVMS help libraries (as well as some programming 

libraries) are distributed in a compressed format. You can use the 
SYS$UPDATE:LIBDECOMP.COM procedure to decompress the libraries all 
at once or individually. For a small system disk, it is almost never worth the 
extra disk blocks consumed to decompress these libraries. The cost of ieayne 
them compressed is a longer access time when you use them. 


If you frequently use help or an individual programming library, it might be 
worthwhile to individually decompress those libraries. If you only infrequently 
use help or do not mind the slower response time of the libraries in compressed 
form, leave them compressed. 


H.6.4 Disabling Log File Creation 


Depending on your environment, there might be system jobs that create log files 
of no concern to you or that contain more information than you need. 


Unless you are a network manager or experiencing network problems, you 
probably do not need to log network events. By not logging network events, you 
can save disk space, a process slot, and some memory in the running system. To 
disable network logging, enter the following commands: 


$:MCR NCP PURGE KNOWN LOGGING ALL 
$ MCR NCP CLEAR KNOWN LOGGING ALL 


You need to enter these commands only once; they become permanent unless you 
reset the DECnet logging information. 


To reduce the logging information for other tasks (such as OPCOM, Accounting, 
Security Auditing, Network Monitor Event Listener, and system-created batch log 
files), you need to add some commands to your system-specific startup command 
file, SYSSMANAGER:SYSTARTUP_VMS.COM (previously called SYSTARTUP_ 
V5.COM). 
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The following is an example SYSTARTUP_VMS.COM command file for a single- 
user workstation: 

$ SET NOON ! Continue thru any problems. 

$! 
$ DEFINE/USER SYSSCOMMAND OPAQ: ! Disable some events from 

$ REPLY/DISABLE=(NETWORK,CLUSTER,SECURITY) ! using the operator window. 


$ SET TERM/SCOPE/PERM OPA0: ! If windows do not start, use as scope. 
S! 
S$ SET AUDIT/ALARM - ! Log interesting audit events. 


/ENABLE= (AUDIT, AUTHORIZATION, ACL, LOGIN=( LOCAL, DIALUP , NETWORK, REMOTE) , - 
LOGFAILURE=ALL , BREAKIN=ALL) 
$! 
S IF FSSEARCH("SYSSMANAGER:ACCOUNTNG.DAT;-1") .NES. "" THEN - 
PURGE SYSS$MANAGER: ACCOUNTNG.DAT/KEEP=4 ! Purge old accounting info 
$! 


S$ IF FSSEARCH("SYSSMANAGER:OPERATOR.LOG;-1") .NES. "" THEN - 


PURGE SYS$MANAGER: OPERATOR.LOG/KEEP=4 ! Purge old operator info 
S$! 
$ DEFINE/SYSTEM/EXEC SYS$SYLOGIN SYSSMANAGER:SYLOGIN ! Set up system login 
$1 


S ENABLE AUTOSTART/QUEUES ! Provide resources for autostart queues 
$ START/QUEUE SYSSBATCH ! Start a batch queue 
S| 


$ SUBMIT/NOKEEP/NOPRINT SYS$MANAGER:STARTNET ! Start net without batch log 
$! 


$! ... add other system specific and layered product commands here ... 


You might have an environment that can function with even less information 
than that shown in the example. For example, to disable the operator log file, 
you would use REPLY/NOLOG, or to disable accounting, you would use SET 
ACCOUNTING/DISABLE. For more information about using these commands, 
see the OpenVMS DCL Dictionary. 


H.6.5 Accessing Example and Documentation Files 


If you have network access to another OpenVMS system (especially a timesharing 
system), you do not need to duplicate the example files distributed in the 
OpenVMS VAX or DECwindows Motif kits if they are available on the remote 
system. Similarly, remote access to the on line documentation files will also save 
considerable disk space on any system with constrained disk space. 


H.7 Managing Multiple Disk Systems 


The following sections describe techniques for managing multiple disk systems. 
In addition to the goal of reducing the space requirements on the system device, 
it is possible to simultaneously reduce some of the I/O load to the system disk by 
redirecting necessary functions to an alternate device. 


H.7.1 Alternate Page and Swap Files 


Setting up alternate page and swap files is one of the best ways to reduce 

both the system disk space usage and I/O overhead. If you set up only a small 
primary page file on the system disk and install additional page and swap files 
in the startup command file SYS$MANAGER:SYPAGSWPFILES.COM, you can 
permanently cause these files to consume the least amount of space on the system 
device. For more information about setting up alternate page and swap files, see 
the OpenVMS System Manager’s Manual. 
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H.7.2 Copying Dump Files 


At startup, you can enhance the use of the paging file as a dump file 

that will automatically copy dump data for later analysis. This releases 

the disk space in SYS$SYSTEM:PAGEFILE.SYS to be used for paging 
automatically as well. Instead of manually invoking the System Dump 
Analyzer (SDA) to release the pages, you can add the following commands to 
the SYS$MANAGER:SYSTARTUP_VMS.COM file: 


S ANALYZE/CRASH SYSSSYSTEM: PAGEFILE.SYS 
COPY alternate disk: [dir]dumpname.ext 
EXIT 


Note 


The dump file, whether it is SYSDUMP.DMP or PAGEFILE.SYS, must 
reside on the system disk. This might limit the actual savings you can 
achieve using alternate page files. 


H.7.3 Offloading System Logs and Files 


There are several system logs and files that can be redirected to another device. 
For other system logs and files, it might be easier to reset and start a new log file, 
copy the old file or files to another device, and purge them from the system disk. 


Some files that can be redirected are the system authorization file, the queue 
manager database, the audit log file, and batch log files. Some files that can be 
reset, copied, and purged are the operator log file, the accounting log file, and 
network log files. For more information about these facilities see the OpenVMS 
System Manager’s Manual, the OpenVMS DCL Dictionary, or the utility reference 
manual for the utility whose files you want to offload. 


H.7.4 Offloading Nonessential Files 


Some of the files included with OpenVMS VAX Version 7.1 can be redirected 

to an alternate device during the installation or upgrade procedure. This can 
save many valuable system disk blocks while providing quick access to these 
files. For a small system disk configuration with multiple disks, this approach is 
recommended if you want the the Help Message utility (MSGHLP) to be available 
on line. 
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boot, bootstrap 


The process of loading system software into a processor’s main memory. This 
guide uses the term boot to refer to this process. 


boot command procedure 


A program, stored on the console fixed disk, that is used to boot the OpenVMS 
operating system from a specified controller. Digital provides a boot command 
procedure for each controller that the processor supports. 


boot name 


The abbreviated name of the boot command procedure you use to boot the system. 


boot server 


A VAX computer that is part of a local area VAXcluster. The boot server is a 
combination of a MOP server and a disk server for the satellite system disk. See 
also satellite node. 7 


Cl only VAXcluster 


A computer system consisting of a number of VAX computers. It uses only the 
computer interconnect (CI) to communicate with other VAX computers in the 
cluster. These computers share a single file system. 


computer interconnect (Cl) 

A type of I/O subsystem. It links VAX computers to each other and to HSC 
devices. See also Hierarchical Storage Controller (HSC) device. 

DECWSTAILOR 

A software program that lets you add or remove DECwindows files from your 
system disk. 

device name 

The name used to identify a device on the system. A device name indicates the 
device code, controller designation, and unit number. 

disk server 

A VAX computer that is part of a local area VAXcluster. This computer provides 
an access path to CI, CSSI, and locally-connected disks for other computers that 
do not have a direct connection. 

Hierarchical Storage Controller (HSC) device 


A self-contained, intelligent, mass storage subsystem that lets VAX computers in 
a VAXcluster environment share disks. Examples are the HSC50 and the HSC70. 
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HSC drive 


Any disk or tape drive connected to an HSC device is called an HSC drive. A 
system disk on an HSC drive can be shared by several VAX computers in a 
VAXcluster environment. 


-InfoServer 


A general-purpose disk storage server that allows you to use the distribution 
compact disc to install the operating system on remote client systems connected 
to the same LAN (local area network). 

local area VAXcluster 


A configuration consisting of one or more VAX computers that act as a MOP 
server and disk server, and a number of low-end VAX computers that act as 
satellite nodes. The local area network (LAN) connects all of the computers. 
These computers share a single file system. 

local drive 


Any drive that is connected directly to a VAX computer. 


media 

Any packaging agent capable of storing computer software. Examples: compact 
discs, magnetic tapes, floppy diskettes, disk packs, tape cartridges. 

MOP server 

A computer system running DECnet that downline loads VAXcluster satellites 
using the DECnet MOP protocol. | 
satellite node : | 

A VAX computer that is part of a local area VAXcluster. A satellite node is 
downline loaded from a MOP server and then boots remotely from the system 
disk served by a disk server in the local area VAXcluster. See also boot server, 
disk server, MOP server. 

save set ; | | 

The format in which the Backup utility stores files. The OpenVMS operating 
system is shipped in this format. 

scratch disk 

A blank disk or a disk with files you no longer need. 

source drive 

The drive that holds the distribution kit during an upgrade or installation. 
spin up, spin down | | 


To spin up means to bring a disk drive up to operating speed; to spin down means 
to bring it to a gradual stop. 


standalone BACKUP 


A subset of the BACKUP utility that is booted into main memory instead of 
running under the control of the OpenVMS operating system. Standalone 
BACKUP is used to back up and restore the system disk and to install OpenVMS 
operating system software. 


standalone system 


A computer system with only one VAX computer. 


system disk 


The disk that contains or will contain the OpenVMS operating system. An 
OpenVMS system disk is set up so that most of the OpenVMS files can be shared 
by several VAX computers. In addition, each computer has its own directory on 
the system disk that contains its page, swap, and dump files. 

target drive 


The drive that holds the system disk during an upgrade or installation. 


transaction log | 
A log used by DECdtm services to record information about transactions. The 
Log Manager Control Program (LMCP) is used to create a transaction log. 
UETP (User Environment Test Package) 

A software package that tests all the standard peripheral devices on your system, 
various commands and operating system functions, the system’s multiuser 
capability, DECnet for OpenVMS, and the VAXcluster environment. 

VAXcluster environment 

A computer system consisting of a number of VAX computers. There are three 
types of VAXcluster environments: CI only, local area, and mixed interconnect. 
VMSTAILOR 


A software program that lets you add or remove optional OpenVMS files from 
your system disk. 
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Accounting logs 
effect of upgrades on, 5-3 
Accounts 
disabling during an installation, 3-14 
setting up after an installation, 4-2 
AGEN$INCLUDE files 
location for upgrades, 5-11 
AGEN$PARAMS.REPORT file, 4—7, 8-12 
Allocation classes 
determining, 2-3 
ALLOCLASS parameter, 2-3 
ANALYZE/DISK_STRUCTURE utility 
error message, 5-8 
using before an upgrade, 5-8 
Auditing files 
replacing after upgrade, 8—2 
AUTOGEN 
accessing data files during an upgrade, 5-11 
AUTOGEN command procedure 
feedback data, 5-5 
running 
after an installation, 4—7 
after an upgrade, 8-11 
at end of an installation, 3—21 
at end of an upgrade, 7-19 
before an upgrade, 5-5 
Automatic restart 
for an upgrade, 5-12 


B 


Backing up the system disk, 4—6, 8-11 
BACKUP command 

using to create a system disk, 3—4 
Backup procedures 

before an upgrade, 5-6 
Boot command procedures 


dddGEN, 7-16 
DEFBOO, 7-16 
Booting 


from console media, 7—8 

from [SYSF], C-—1 to C-—6 
manually during an upgrade, 7-8 
with InfoServer ISL file, 3-2 


Index 


Building standalone BACKUP, 4-2 


C 


C2 systems, 2-3 
Checklists 
postinstallation, 4—7 
postupgrade, 8-12 
preinstallation, 2-6 
preupgrade, 5-15 
CI only VAXcluster 
information needed to install, 2-3 
Clusters 
See also VAXcluster environments 
group numbers, 2—4 
passwords, 2-4 


Cluster upgrades 
See Concurrent upgrades 


See Rolling upgrades 
CLUSTER_SIZE parameter 
of system disk, 3-5 
Command procedures 
checking after an upgrade, 8—3 
Common files 
coordinating for multiple boot servers, G—2 
coordinating for multiple system disks, G—2 
Compact disc kit 
contents of, 1-5 
Computer-specific installation instructions, 3-1 
Concurrent upgrades, 6—1 
restrictions, 6—1 
setting QUORUM parameter, 6-2 
upgrade procedures, 6—2 
CONSCOPY.COM procedure, 5—7 
Console 
connecting with SYSGEN, 8-4 
Console media 
automatic update during an upgrade, 5-7 
backing up after an upgrade, 8-11 
backing up before an upgrade, 5-7 
booting from during an upgrade, 7-7 
copying, 5—7 
modifying for automatic restart, 5-12 
modifying to boot from [SYSF], 7-7 
required for an installation, 2-7 
required for upgrades, 5-5 
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Console media (cont’d) 
restoring original boot command procedures, 
7-16 
updating after an upgrade, 8—4 
using backup copies, 5-7. 
Creating a system disk, 3-4 
from InfoServer devices, 3—7 
Customizing the system, 4—2 


D 


Date 
format for entering, 7-6 
dddGEN boot command procedure 
restoring original version, 7—16 
DECnet 
configuring after an installation, 4—3 
DECnet for OpenVMS 
preparing for an upgrade, 5-12 
DECnet node addresses, 2-3 
DECnet node names, 2-3 
DECnet Phase IV, 1-1 
ignoring during startup, 4-4 
installing on system, 1-1 
running with DECwindows Motif, 4-4 
DECnet—Plus, 1-1 
choosing to install, 3—11, 7-12 
installing during an installation, 3-20 
installing during an upgrade, 7-18 
removing from system, 1-1 
DECnet-—Plus license _ | 
registering after an installation, 4—2 
registering during an installation, 3-19 
- registering during an upgrade, 7—17 
Decompressing system libraries 
after an installation, 44 
after an upgrade, 8-7 
DECset Version 11 | 
caution before upgrading, 5-2 
changing the default debugger 
after upgrading, 5-2 
before upgrading, 5-2 
DECW$IGNORE_DECNET logical name, 4—4 
DECW$MOTIF_TAILOR utility, H—4 
DECWS$TAILOR utility 
3 using on a small system disk, H—4 
using to install optional components, 3-8 


using to remove files from a system disk, 4-6, 


8-8, 10-7, 10-8 
DECwindows Motif for OpenVMS 
minimum version requirement, 1-2 
support for, 3-10 
tailoring, 8-8 
using with OpenVMS VAX Version 7.1, 2-2 
DECwindows support components, 5-14. 
base support, 3-10, 7-11 
choosing options 
during an installation, 3-10 
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DECwindows support components 
choosing options (cont'd) | 
during an upgrade, 7-11 
customizing, 9-1 | 
customizing after an upgrade, 8-9 
customizing the server, 9-1 
display server files, E-1 
distribution media 
removing from drive, 3-13 
font files, E-1 
installing, 2-6, 3-13 
sizes, 3-10, 7-11 
TCP/IP transport, 9-5 
transports, 9-5 | | 
using customer-written transports, 9-6 
workstation support, 3-10, 7-11 
Default volume label, 3—7 
DEFBOO boot command procedure 
restoring original version, 7—16 
Device names 
determining, 2-4, 3-4 
format for upgrade, 7-4 
HSC name format for an upgrade, 7-4 
Devices | 
configuring before an upgrade, 7-2 


DIGITAL Storage Systems Interconnect (DSSI) 
disks | 
See DSSI disks 
Digital TCP/IP Services for OpenVMS 
configuring, 9-6 
function, 9-5 
installing mandatory update, 4—6, 8-10 
Directories 
processed during an upgrade, 7-15 
Directory trees 
merged during an upgrade, 7-15 
Disk drives 
selecting for an installation, 2—4 
Disk space 
increasing on the system disk, 8-8, H-1 
needed for an upgrade, 5-9 
needed to decompress libraries, 8—7 
needed to decompress system libraries, 4—4 
needed to run UETP, 4-4, 8-8 


Distribution kit 


compact disc, 1-5 

magnetic tapes, 1-5 

OpenVMS VAX, 3-2 

save sets in, 1-4 

Standalone BACKUP, 3-2 

tape cartridges, 1-5 

TK50 tape cartridges in, 3-1 

with multiple volumes, 3-1 
Distribution media, 1-3 

loading, 7-3 

location during an upgrade, 5-3 
multiple volumes, 7-3 


DSSI disks 
device name change, 2-2 

Dump files 
checking size, 8-3 
controlling size of, H-3 
modifying size, 8-3 
purged during an upgrade, 7-13 
requirement for an upgrade, 5-8 
shared, 5-4, 5-8 


E 


Editing startup files, 4—2 
Error formatter (ERRFMT) 
stopped during an upgrade, 7—7 
Errors during installation 
license messages, 3-6 
Errors during upgrades 
cluster hang during shutdown, 6-4 
console update, 8—5 
while entering device code, 7-5 
EXPECTED_VOTES parameter, 8—4 
setting for rolling upgrade, 6—4 


- 


Factory installed software 


See FIS 
Feedback data 

checking before an upgrade, 5-5 
FIELD account | 

setting passwords, 3-14 
FIS (Factory installed software), xiii 


H 


Hardware 
supported, G—7 
Help Message save set 
contents, D-2 
Help Message utility 
installing, 2—5, 3-9 
Hierarchical Storage Controller (HSC) 


See HSC 
HSC 
device format for an installation, 3—4 
device format for an upgrade, 7—4 
displaying name of, 2—4 
drives, 1—4 
names, 3—4 
preparing for installations, 2—4 


InfoServer devices, 1—4 


booting Standalone BACKUP, 3-2 
creating the system disk from, 3—7 


Initial software load (ISL) 


See ISL 


Installation 


of layered products, 4—6, 8—10 


Installation procedure, 1-6 


See also Postinstallation tasks 

See also Preinstallation tasks 

booting standalone BACKUP, 3-1 

booting system disk after transferring required 
save set, 3-6 

computer-specific instructions, 3-1 

rebooting the system, 3-22 

registering licenses, 3-16 

registering OpenVMS VAX license, 3-22 

running AUTOGEN, 3-21 

selecting optional components, 3-8 

setting passwords, 3-14 

stages of, 3-1 

time zones, 3-20 

when to use, 1-6, 2—1 


Installing 


DECwindows software, 3-13 
optional components, 3-7 


Installing the operating system, 3-1 


C2 systems, 2-3 — 

cautions and restrictions, 2-1 

information needed for VAXcluster systems, 
2-3 

preparing for, 2-3 

recording log of, 2-2 

VMSINSTAL option G warning, 2-1 


ISL Gnitial software load) 


booting, 3-2 


Keyboards 


customizing, 9-2 
layout, 9-1 

DECwindows keymap, 9-3 to 9-5 
model numbers, 9-2 


Keymap names 


determining, 9-2 


KFQSA controller 


upgrade requirement, 5-11 


Index—3 


L 

Layered products 
availability of, 1-3 
effect of upgrade on, 5-5 


installing after OpenVMS VAX installation, 


4—6 
installing after upgrade, 8—-i0 
LIBDECOMP.COM procedure, 8-7 
running after an installation, 4-5 
running after an upgrade, 8—7 
Libraries | 
decompressing after an installation, 4—4 
decompressing after an upgrade, 8—6, 8-7. 
Library save set 
contents, D-1 
installing, 3-8, 7-9 
License Management facility 


See LMF 
Licenses 
See also LMF 
See also PAK 
error messages, 3-6 
registering after an installation, 4—2 


registering during an installation, 3-16, 3-18 


registering during an upgrade, 7-17 
required for upgrades, 5-1 
types of, 3-16 to 3-17 
License Unit Requirement Table 


See LURT 
Limits 
minimum values, 5-9 
LMF (License Management facility) 
error messages, 3-18 
example of registration, B-2 
license registration procedure, B-1 
system integrated product licenses, B—7 
using during an installation, 3-18 
Volume Shadowing software, B—7 
Local Area VAXcluster 
information needed to install, 2-3 
upgrade requirements, 5-3 
Local drives, 1-4 | 
LURT (License Unit Requirement Table), B—3 


M 


Magnetic tape kit 
contents, 1-5 

Manual boot 
after running AUTOGEN, 7-1 
during an upgrade, 7—8, 7-16 
enabling for an upgrade, 5—12 

Memory requirements 
restrictions, 1-3 
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MicroVAX computers 

booting from [SYSO], 7-16 

booting from [SYSF], 7-13, C-1 
Minimum startup 

configuring devices after, 7-2 

setting before an upgrade, 5-10 
Mixed-interconnect VAXcluster 

information needed to install, 2-3 — 

upgrade requirements, 5-3 
Mixed-version cluster 

upgrading to, 6—3 to 6—5 
MODPARAMS.DAT (parameter file), 4—7 

entering parameters in, 5-12 

modifying, 8—4 

modifying values, 8—11 
Monochrome workstations, 9-2 
Multiversion upgrade, A-1 


N © 
NETCONFIG.COM procedure 
running after an installation, 4-3 
Network : 
See also DECnet for OpenVMS 
requirements for an upgrade, 5-13 
restriction on upgrades, 5-3 
Networks 
configuring the system for, 4—3 
NEW_OVER files, F—2 
NEW_UNDER files, F-—2 


O 


OPCOM 
stopped during an upgrade, 7—7 
OpenVMS library files 
choosing during an upgrade, 7—9 
OpenVMS Management Station 
installing, 3-9, 7-10 
postupgrade tasks, 8-10 
OpenVMS optional components 


See Optional components 
OpenVMS RMS Journaling license 
registering after an installation, 4—2 
registering during an upgrade, 7-17 
OpenVMS VAX distribution media 
loading, 3-4 
OpenVMS VAX license 
registering after an installation, 4-2 
OpenVMS versions 
computer support, B-—2 
required for upgrades, 5-4 
Operator logs 
effect of upgrades on, 5-3 
Optional components 
choosing, 2-5 
installing on alternate disks, 3-8 
installing with DECW$TAILOR, 3-8 


Optional components (cont’d) 


installing with VMSTAILOR, 3-8 
selecting, 3-8 
selecting during an installation, 3-7 
selecting during an upgrade, 7-9 
sizes, 3—7 

Optional save set 
contents, D-—2 
installing, 3-8, 7-10 
upgrading, 7—9 


Pp 


Page and swap files 

locating, 2-4 
Page files 

checking size, 5-9, 8-3 

controlling size of, H-3 

modifying size, 5-9, 8-3 

purged during an upgrade, 7-13 

recommended location, 5-8 

size required for an upgrade, 5-9 
PAK (Product Authorization Key) 

registering after an installation, 4-2 

registering during an upgrade, 7-17 

registering during installation, 3-18 
Passwords 

forgotten, 3—23, 7-20 

for system accounts, 2-5 

setting during installation, 3-14 

minimum length, 3-14 

modifying during upgrade procedure, 7—6 

requirements, 7—6 
Phase 1 of upgrade procedure, 7—6 
Phase 2 of upgrade procedure, 7-14 
Phase 3 of upgrade procedure, 7—15 
Phase 4 of upgrade procedure, 7-15 
Phase 5 of upgrade procedure, 7—16 
Phase 6 of upgrade procedure, 7—17 
Postinstallation tasks, 4—1 

adjusting system parameters, 4—2 

backing up the system disk, 4-2, 4-6 

configuring DECnet, 4-3 

creating standalone BACKUP, 4-2 


customizing DECwindows support software, 


9-1 

customizing the system, 4-2 

decompressing system libraries, 4—4 

editing startup procedures, 4—2 

installing layered products, 4-6 

registering licenses, 4—2 

removing unwanted system files, 4—6 

running UETP, 4-4 

setting up user accounts, 4-2 

tuning the system with AUTOGEN, 4-7 
Postupgrade tasks 

adding and removing files, 8—8 

backing up console media, 8-11 


Postupgrade tasks (cont’d) 


backing up system disk, 8-11 

changing MODPARAMS.DAT, 8-4 
checking system file sizes, 8-3 

creating standalone BACKUP, 8-11 
customizing DECwindows support, 8—9 
decompressing system libraries, 8—6 to 8-8 


examining command procedure templates, 8-3 


increasing space on the system disk, 8-8 
installing layered products, 8-10 
modifying size of dump file, 8—3 
modifying size of page file, 8-3 
modifying size of swap file, 8-3 

purging system files, 8-9 

replacing SYSUAF.DAT, 8-2 

replacing VMS$AUDIT_SERVER.DAT, 8~—2 
running AUTOGEN, 8-11 

running UETP, 8-8 | 
tuning the system with AUTOGEN, 8-11 
updating console media, 8-4 

using VMSTAILOR, 8-8 


Preinstallation tasks, 2-3 


collecting information, 2—5 

determining HSC name, 2-4 

preparing for VAXcluster environments, 2-3 
preparing tape drives, 2—4 


Preupgrade tasks, 5-1 


analyzing and repairing the system disk, 5-8 
backing up console media, 5—7 
backing up the system disk, 5-6 
checking page file size, 5—9 
configuring devices, 7—2 

creating standalone BACKUP, 5-7 
preparing DECnet for OpenVMS, 5-12 
preparing the system disk, 5-7 
preventing interactive logins, 5-12 
running AUTOGEN, 5-5 

setting system parameters, 5-10 
stopping queues, 5-13 


Products (VMSINSTAL) 


specifying for an upgrade, 7-5 


PURGE command, 8—9 
Purging system files, 8—9 


Q 


Queue database 


creating after an upgrade, 4—2 


Queue manager 


restoring preferred node list, 8—2 


Queues 


requirements for an upgrade, 5-13 
stopping batch/print, 5-13 
stopping before an upgrade, 5-13 


Quorum 


maintaining during rolling upgrades, 6—4 
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Quorum disk, 2-3 
QUORUM parameter 
setting for concurrent upgrades, 6-2 
Quotas 
checked during an upgrade, 7-7 
minimum values, 5-9 


R 
Rebooting 

after an installation, 3-22 

manual, 5-12 
Recording an installation, 2-2 
Removing unwanted system files, 4—6 
Required save set | 

transferring to the system disk, 3-4 
Restart 

enabling sats 5-12 
Restrictions 

for installations, 2-2 
Rights database 

creating during an installation, 3-15 
RIGHTSLIST.DAT file 

creating during an installation, 3—15 
RMS Journaling for OpenVMS license 

registering during an installation, 3-19 
Rolling upgrades, 6-1 

effect on SYSUAF.DAT, 8-2 

effect on SYSUAF.DAT file, 5-8 

maintaining cluster quorum, 6—4 

restrictions, 6—1, 6-3 

source drive requirement, 6-4 

upgrade procedures, 6—3 to 6—4 


S 


Satellites nodes 
upgrade requirements, 5-3 
Save sets 
installing on an alternate disk, 5-14 
location on magnetic tape, 1-5 
required location, 1-4, 2-2 
tape cartridge containing, 3-2 
transferring to the system disk, 3-4 
SCSNODE parameter, 5-10 
SCSSYSTEMID parameter, 5-10 
Selecting optional components, 7-9 
Server 
customizing the DECwindows, 9-1 
Shared memory 
restrictions, 1-3 
Shutdowns 
before an upgrade, 5-7 
Site-specific command procedures 
restored during an upgrade, 7-17, 8-3 
Snapshot facility 
resetting the BOOT_STYLE parameter, 5-11 
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Software Product Descriptions (SPDs) 


See SPDs 
Source drives, 1-4 

definition, 7-2 

requirement for VAXcluster upgrade, 6—4 
SPDs (Software Product Descriptions) 

location on the distribution kit, 1-5 
STABACKIT.COM (procedure to create standalone 

BACKUP), 5-7 

Standalone BACKUP 

booting, 3-1 

booting from InfoServers, 3-2 

booting from tape cartridges, 3-1 

booting on VAX 9000 computers, 3-2 

creating after an upgrade, 8-11 

creating a kit, 4-2 

creating before an upgrade, 5-7 

loading media, 3-1 

locating on distribution kit, 3-1 

on multiple volumes, 3-1 

upgrade requirements, 5—7 

using alternative backup procedure, 3-3 
Startup files 

editing after an installation, 4-2 
STARTUP_P1 parameter 

setting to MIN, 5-10 
Swap files 

checking size, 8—3 

controlling size of, H-38 

creating, 5-9 

modifying size, 8-3 

purged during an upgrade, 7-13 

recommended location, 5-8 
SWAPFILES.COM procedure 

executing to change system file sizes, 8-3 

to check or modify page file size, 5-9 

to create swap file, 5-9 
SYCONFIG.COM procedure 

editing after an installation, 4—2 
SYLOGICALS.COM procedure 

editing after an installation, 4—2 
SYLOGIN.COM procedure 

editing after an installation, 4-2 
SYS$TIMEZONE.DAT file, 7-8 
[ISYSF] directory 

booting from during an upgrade, 7-13, C-1 

booting from during upgrade, 7-1 

command to boot MicroVAX and VAXstation 

computers from, 7-13 | 

[ISYSF] directory tree | 

built by upgrade procedure, 7-8 

deletion of, 7-16 | 
SYSGEN parameters 

See System parameters 
SYSGEN utility 

ALLOCLASS parameter, 2-3 

configuring devices, 7—2 


SYSGEN utility (cont'd) 


using to connect console, 8—4 
SYSTARTUP_VMS.COM procedure 
editing after an installation, 4—2 
editing to control DECnet Phase IV, 4—4 
SYSTEM account | 
forgotten passwords, 3-23, 7-20 
limits, 5-9 
quotas, 5-9 
setting passwords, 3-14 
System disks, 1-4 
analyzing and repairing, 5-8 
backing up, 8-11 
backing up after an installation, 4—2, 4-6 
backing up before an upgrade, 5-6 
booting a backup copy, 5—7 
booting after an installation, 3-22 
booting after transferring required save set, 
3-6 
checking amount of free space on, 4—5 
CLUSTER_SIZE parameter, 3-5 
creating, 3-4 
customizing with DECW$TAILOR, 4-6, 10-7, 
10-8 
customizing with VMSTAILOR, 4-6, 8-8, 10-1 
dealing with limited space, H-—1, H-2 
disk space needed to run UETP, 4-4, 8-8 
free space needed for an upgrade, 5-9 
free space needed to decompress libraries, 4—5 
preparing for an upgrade, 5-7 
preparing for installations, 2—4 
removing unwanted files from, 4—6 
required location during an upgrade, 7—16 
restrictions, 1—3 
RZ24, H-2 
Space requirements, H-2 
specifying volume label for, 3—7 
System files 
modifying, 8-3 
purging, 8-9 
System Generation utility 


See SYSGEN utility. 
System hang, 7-20 
System libraries 
decompressing, 3-15, 8—6 to 8-8 
sizes after decompressing, 8-6 
System parameters 
adjusting, 4-2 
generated by AUTOGEN feedback, 5-5 
requirements for an upgrade, 5-3, 5-10 
System password dictionary 
restoring after an upgrade, 8—9 
System shutdowns 
after an installation, 3—22 
System time, 4-1, 8-2 
SYSTEST account 
setting passwords, 3-14 


SYSTEST_CLIG account 
disabling during an installation, 3-14 


SYSUAEDAT file 
See UAF 


7 


Tailored system disks 
See DECW$TAILOR utility 


See VMSTAILOR utility 
Tailoring 
on small system disks, H-—2 
Tape cartridge 
containing save sets, 3-2 
containing standalone BACKUP, 3-1 
Tape drives | 
preparing for an installation, 2—4 
selecting for an installation, 2—4 
Target disk 
using backup copy for, 5-6 
Target drives, 1—4 
definition, 7—2 
TCP/IP software 
See Digital TCP/IP Services for OpenVMS 
Time 
format for entering, 7-6 
Time zones 
updating during an installation, 3-20 
updating during an upgrade, 7-18 
TK50 tape kit 
contents of, 1-5 
Transferring save sets to the system disk, 3-4 


U 


UAF (user authorization file) 
effect of rolling upgrades on, 5-8, 8-2 
purged during an upgrade, 7-13 
replacing after upgrade, 8-2 
required location, 5-8 7 
UETP (User Environment Test Package) 
disk space needed torun, 4—4, 8-8 
when to run, 4—4, 8-8 
UPDATE_CONSOLE.COM procedure 
running after an upgrade, 8-6 
Upgrade and installation supplements 
using, 2-2, 3-1 
Upgrade preparation, 5-11 
Upgrade procedure, 1-9 
automatic update of console media, 5—7 
booting from console media, 7—7, 7-8 
booting from [SYSF], 7-13 
booting manually during, 7-8 
building [SYSF] directory, 7-8 
cautions and restrictions, 5-1 
choosing optional OpenVMS components, 7-9 
concurrent upgrades, 6—2 
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Upgrade procedure (cont'd) 


console media required, 5-5 

conversion of VAXVMSSYS.PAR, 7—16 

correcting directory pointers, 7-15 | 

deletion of [SYSF] directory tree, 7—16 

disk space needed for page files, 5—9 

disk space requirement, 5-9 

effect on accounting logs, 5-3 

effect on command procedures, 8-3 

effect on layered products, 5-5 

effect on MODPARAMS.DAT, 8-4 

effect on operator logs, 5-3 

enabling automatic restart, 5-12 

enabling manual reboot, 5-12 

error entering device code, 7—5 

files deleted by, 7-8, 7-15, 7-16 

files purged during, 7-13 

interrupting before Phase 1, 7-6 

license requirements, 7—17 

loading OpenVMS VAX distribution media, 7-3 

manual reboot after, 7—19 

manual reboot from [SYSO0], 7—16 

merging directory trees, 7—15 

modifying console media, 5—12 

modifying console media to boot from [SYSF], 
7-7 

modifying passwords, 7-6 

OpenVMS version requirement, 5-4 

Phase 1, 7-6 


Phase 2, 7-14 
Phase 3, 7—15 
Phase 4, 7-15 
Phase 5, 7-16 
Phase 6, 7-17 


processing user files, 7—15 
recording logs, 5-5 
registering licenses, 7—17 
required location of save sets, 5-3 
required location of the system disk, 7—16 
requirement for shared dump files, 5-8 
requirements, 5-15 
restoring original dddGEN, 7-16 
restoring original DEFBOO, 7-16 
rolling upgrades, 6-3 
adding a new CPU, 6-5 
running AUTOGEN, 7-19 
selecting optional components, 7—9 
shared dump files, 5-4 
system files renamed by, 7-8 
time zones, 7—18 
using a printer to record output, 5-5 
-VMSINSTAL option G warning, 5-3 

when to use, 1-9, 2—1 

User authorization file 
See UAF 

User files : 
processed during an upgrade, 7-15 
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V 


VAXcluster environments 
building, 4-2 
cluster group numbers, 2-4 
cluster passwords, 2—4 
DECwindows support components for, 3-10, 
7-11 
information required for an installation, 2-3 
problem upgrading, 7—20 
types of, 2-3 
upgrade requirement for shared dump files, 
5-8 
VAXcluster license 
registering after an installation, 4—2 
registering during an installation, 3-19 
registering during an upgrade, 7-17 
VAXcluster quorum 
maintaining during an upgrade, 7—20 
maintaining during rolling upgrades, 6—4 
VAXcluster QUORUM parameter 
setting for concurrent upgrades, 6-2 


VAXcluster upgrades 
See Concurrent upgrades 


See Rolling upgrades 
VAX computers 
booting from [SYSF], C-—1 to C-6 
OpenVMS VAX support for, B-—2 
VAXft computers 
booting from [SYSF], C-1 
VAXstation computers 
booting from [SYSO], 7—16 
booting from [SYSF], 7-13, C-1 
VAXVMSSYS.PAR parameter files 
conversion, 7-16 
VMB.EXE | 
copying to console media, 8—4 
VMS$AUDIT_SERVER.DAT file 
required location, 5-8 
VMSINSTAL command procedure 
- invoking for upgrade, 7-3 
option G warning, 2-1 
VMSTAILOR utility 
using on a small system disk, H—4 
using to install optional components, 3-8, 7-9, 
10-3 
- using to remove files from a system disk, 4-6, 
8-8, 10-3 | 
Volume label 
specifying during an installation, 3-7 
Volume shadowing 
requirements for an upgrade, 5-13 
Volume Shadowing license 
registering after an installation, 4—2 
registering during an installation, 3-19 
registering during an upgrade, 7—17 
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checking for rolling upgrades, 6-3 
setting for concurrent upgrades, 6-2 
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W 


WELCOME. TXT file 


updating, 8-3 
Workstations 
customizing, 9-2 


X 


X terminals 


DECwindows support components for, 3-10, 


7-11 


Iindex—9 


\ Wa y A GLAM we: 
WANN \ i Y NWA 2 iN, F Wes 
WAWMININNE NW Wi \ i ' \ : Ny : NNN ae at Wis Nae 


Na Wily, 
"Nh Ny AY 


i ae 


Ny 


i iN Ni AAI 
aN Wy Maal 


MT 
A eH 
WW 


Printed on 
AA-QSBQB-TE Printed in U.S.A. Recycled paper 


